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Preface 


omputers and microcontrollers cover a very wide field of devices 

and systems, from the small low-cost, single-chip device used to 

control domestic appliances such as toasters and washing machines, 
right up to the mainframe computers used by large organisations. The 
subject of digital signal processing pervades many areas of amateur radio 
now from simple audio processing to the latest data modes. Within this book 
we will cover the typical range of devices that are available to the home user 
and constructor, and see how they can be made to work in conjunction with 
many amateur radio applications to provide operator assistance, give access 
to new communications techniques and add a level of sophistication and 
usefulness to a whole range of home-constructed projects that would have 
been impossible, or at least very complex, without involving a processor. 

In Chapter I, we look at the uses that can be made of the personal com: 
puter. Some of the general-purpose applications software that is of imme- 
diate use to the radio amateur will be covered, such as spreadsheets and 
how this is now the software of choice for exploiting measurement data 
and performing calculations that were once the preserve of custom soft- 
ware. An introduction to computer programming shows how to write sim- 
ple programmes and how these can be built up into quite complex soft- 
ware suites. Data modes are covered in outline, although this aspect of 
using computers for on-air communications is covered very comprehen- 
sively by Murray Greenman, ZL1BPU, in his book listed in the references 
for this chapter, and so will we will not go into too much detail here. 

Chapter 2 expands the uses that can be made of the PC by interfacing to 
the outside world through its various input/output ports and covers these 
in some detail, including the software and hardware needed to make use of 
the parallel and serial (COM) ports. The design of hardware to plug into 
the older PC busses as well as timing issues, the use of other ports, isolation 
and EMC issues are discussed. 

Chapter 3 introduces the PC as a tool for controlling amateur radio 
transceivers. Software techniques covered include band monitoring, spec- 
trum analysis and spectral usage as well as automatic beacon monitoring. 
The intricacies of control of the transceivers supplied by different 
manufacturers is described, with various software techniques to make this 


aspect easier to handle. The CFAR technique for signal detection in noise 
is described, and also how the Global Positioning Satellite system offers new 
possibilities for signalling with its very accurate timing. 

Chapter 4 introduces the microcontroller, concentrating mainly on the 
PIC device from Arizona Microchip, but also covering the products of- 
fered by some other manufacturers. A general introduction to program- 
ming the PIC is augmented by some of the basic routines common to many 
of the uses to which these devices may be put in amateur radio applica- 
tions — such as serial interfacing, analogue-to-digital conversion, displays 
and basic user input/output devices. Chapter 5 introduces a number of 
simple stand-alone projects making use of the PIC, such as applications for 
automatic SWR measurement, frequency measurement, data logging, and 
a low-cost direct digital synthesiser. 

Chapter 6 covers the area of remote control in some depth. Software 
and hardware in this section is described not so much for it to be used 
directly in complete projects, but as a source of programming techniques 
and algorithms that users can draw on and adapt at will to their own de- 
signs. Hardware for interfacing RF and telephone line signalling is described, 
along with some security and coding issues. PIC techniques are expanded 
in Chapter 7 where a number of projects are covered that involve more 
complex and subtle programming, and hardware tricks. 

The principles behind digital signal processing are introduced in Chap- 
ter 8, with many of the basic algorithms common to most DSP applications 
described. Chapter 9 covers hardware and systems needed to use DSP at 
home and covers the specialities of DSP chips, their starter kits and evalu- 
ation modules. 

Finally, in Chapter 10 we are indebted to Alberto de Bene, I2PHD, fora 
comprehensive description of Windows programming and using the sound 
card. Alberto describes how using this operating system introduces new 
concepts in programming, and takes a digital comb filter programme as a 
worked example of how software for the sound card is developed in 
Windows. 


Software listings 


Now a note about software and programme listings. A lot of this book is 
taken up with describing various software techniques and algorithms. In 
many cases these will be shown as a listing of the commands needed to 
fulfil the tasks described, although most of these listings cannot be used in 
isolation. All computers and microcontroller programmes require some 
overhead to set up internal registers, input/output ports and suchlike. In 
many cases this overhead has a lot in common between multiple pro- 
grammes, although the actual names of registers and ports will likely be 
different. Due to the general similarity, this overhead code will not be shown 
for the majority of listings. The techniques needed to generate the specific 
starting code will be covered in the introductions in each case, and usually 
can be adopted with slight modifications as appropriate to suit any end 
application. Where listings are given for various techniques and algorithms, 


each listing will need to be included with all the additional set-up instruc- 
tions specific to the way it is being used; all listings will have sufficient 
comments to allow this to be generated where the information is not self- 
evident. More comprehensive listings will usually be available from the 
RSGB website page that accompanies this book, including many stand- 
alone programmes that are not shown in full here. The page is at: 


http://www.rsgb.org/books/extra/command.htm 


In the chapters on DSP, a number of the algorithms or DSP routines are 
illustrated by what I (and a college lecturer from the dim and distant past) 
call pseudocode. This is a fictional computer language making use of a rea- 
sonably straightforward set of basic commands that are self-explanatory, 
and with obviously named variables. It often looks a lot like the Basic 
language, but introduces and manufactures various functions as required. 
This route has been chosen as a number of readers will want to implement 
the DSP routines on Windows-based computers using their own preferred 
language. All the overhead commands associated with Windows program- 
ming would only obfuscate the basic underlying code, which is many cases 
is straightforward to convert to another language. Also, conversion to na- 
tive code for various DSP chips is made simpler if there are no extraneous 
commands in the original listing. 
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CHAPTER 


The personal computer 


The beginnings of home computing 


Although computers as we know them have existed in some form or an- 
other for over half a century, they only began to appear in amateur radio in 
the ’seventies. Back then, computers were nearly always home constructed 
around one of the few microprocessor chips available, and programmed, 
usually from first principles, by the builder. Programming the very first 
models had to be done in the native machine code of the microprocessor, 
frequently by setting the code to be programmed on DIP switches then 
pressing a programme button, one byte at a time. Needless to say, large 
programmes could take many days or weeks to get going, as just one switch 
set erroneously would crash the whole computer. Kits and ready-made 
boards with ready-installed simple operating systems and machine code 
‘assemblers soon became available, and these made programming a lot easier 
for many users. It was about this time that radio amateurs started introduc- 
ing computers to radio, and probably one of the first uses was to replace the 
noisy mechanical teleprinter for radio teletype (RTTY) operating. 

Interest in home computing grew rapidly, and complete ready-made home 
computers with proper keyboards, usually making use of a domestic televi- 
sion as the monitor, soon became available. These were initially eight-bit 
machines based around standard microprocessors, and most domestic home 
computers came with a high-level programming language to give the ma- 
chine a wider appeal than just to computing enthusiasts. The language sup- 
plied was nearly always a version of Basic (Beginners All-purpose Sym- 
bolic Instruction Code) which still exists, in a number of different variants, 
to this day. The BBC Computer which appeared around 1980 was arguably 
the stimulus for a huge increase in computer home usage. This was an eight- 
bit machine, supplied with a very comprehensive version of Basic, and had 
huge flexibility for expansion and interfacing to the outside world. The 
ease of interfacing meant that the BBC Computer was still in use in educa- 
tion as well as at home until well into the ’nineties. 

These early eight-bit machines were rarely powerful or fast enough when 
programmed in Basic to work directly with real-time data or audio from an 
amateur radio system, and the rare few who did want to pursue this route 
were forced to go back and learn the intricacies of machine code or 
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Processing power in bits 


The ‘size’ of a processor or microcontroller is defined by the number of bits used 
to form its instruction cycle or data word. The very earliest microprocessors used 
only four bits, allowing 24 = 16 different values. These chips were of very limited 
use, being restricted to jobs such as controlling washing machines! Very soon 
_ eight-bit processors such as the 6800, 6502 and Z80 chips became available and 
| these formed the basis of the first home computers. 16-bit processors followed 
and now the home PC with a 80386 or higher processor makes use of a 32-bit 
architecture. 

The number of bits defines how numbers are handled. An eight-bit machine can 
only handle the integers 0 to 255 in a single word. By making use of two words, 
integers from O to 65535 (or —32768 to 32767) are possible. Floating point 
_ numbers as used for most mathematics require at least 32 bits, so eight-bit and 16- 
_ bit machines have to use two or four words per value, making them inherently 
_ slower as multiple memory locations need to be accessed for each value. 


assembler. Hence the main use to which home computers were put was for 
running applications software. They were also connected to radios for 
processing data to and from an interface that converted the audio signals 
carried by the radio link to data — this interface was the modem, short for 
‘modulator/demodulator’. This configuration made possible first radio 
teletype modes, then more advanced communications modes incorporating 
error correction such as AMTOR, introduced to the amateur world by 
G3PLX. 

During the mid-’eighties packet radio also became popular, usually 
making use of a dedicated terminal node controller which coptained a 
separate microcontroller in its own right, although some packet radio 
software could run completely on a host computer and required just a simple 
one-chip modem to interface to the radio. Once such system was produced 
by Baycom [1] and is probably the simplest way of getting a basic packet 
radio station together. 

The IBM Personal Computer first appeared around 1983 and was at first 
used mainly for business due to its cost. However, the popularity of this 
model rapidly grew, bringing price reductions as more and more manufac- 
turers produced ‘clones’. The PC started out initially as an eight-bit ma- 
chine but soon the increased capability of 16-bit processing came with the 
introduction of the 80286 processor models. 

Now, home and business use was driving the market, making the PC and 
its Microsoft MSDOS operating system dominant throughout the world. 
Microsoft introduced its graphical user interface-based Windows operating 
system in 1991. Shortly afterwards, processor enhancements meant that 32- 
bit computing power became the norm, and the Windows operating sys- 
tem was enhanced until we reach the present situation where many families 
have a 32-bit computer in their homes. During this rapid development in 
the lifecycle of the personal computer, there was a parallel massive soft- 
ware development programme with much of the later software requiring an 
upgrade to a more powerful machine to make use of its full capabilities. 
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This meant that older, slower machines became obsolete before they might 
otherwise have done, and appear frequently as surplus at low cost. 

Remember that a lot of very useful software can run perfectly happily on 
machines 15 years old — considered antique by modern standards! Such 
machines are often available as scrap and in some cases, particularly for 
interfacing and control, can be more useful to the radio amateur than the 
latest 32-bit machine running Windows. 


Computer operating systems 


All but the very first PCs used a disc-based operating system, usually MSDOS 
or PCDOS. This is usually resident on a hard disc (although the OS can run 
from a floppy disc) and presents the user with a text-based means of com- 
munication with the computer, by typing in commands in longhand. Ex- 
tensive commands are available for formatting discs, copying, renaming 
and deleting files, and for setting the operating parameters of the machine. 
This straightforward user interface hides the real complexities of the DOS 
operating system, however. Inside the DOS software is a whole array of 
mini routines for interfacing to the machine hardware and providing the 
various ‘hooks’ so that higher-level software, such as Basic or any other 
programming languages, can interface to the outside world in a straightfor- 
ward manner. 

For serious programmers who want to access more of the capabilities on 
a typical PC than are available through the high-level programming lan- 
guage, it is possible to call the numerous DOS routines directly, giving 
access to the whole machine’s capabilities. For example, to use the mouse 
in a DOS environment requires separate calls to the operating system to get 
the current cursor X and Y co-ordinates, detect buttons pressed and show 
or hide the cursor, or limit its travel. The DOS operating system is called by 
loading processor registers and calling an interrupt. 


The Windows operating systems 

The first graphical-based PC operating systems, up to Windows 3.x, still 
relied partially on the underlying DOS and its interrupt calls, although add- 
ing levels of complexity of its own. When running Windows 3.11, for ex- 
ample, it is possible to call up a DOS window which behaves exactly the 
same as if DOS were the native operating system in use. The later 32-bit 
operating systems, starting with Windows 95, then Windows 98, 2000, ME 
etc no longer interfaced to the machine hardware via DOS. In fact ‘plug- 
and-play’ had by now appeared so that hardware and accessories could be 
identified directly by the operating system, making it much simpler for the 
user to install new hardware. 

This gives us a problem if we want to run older ‘legacy’ software written 
for DOS, and do some ‘out-of-the-ordinary’ tricks with a PC that could 
involve trying to interface it to the outside world. All is not lost, fortunately. 
The operating systems designed primarily for single users, such as Win- 
dows 95, 98, 2000 and ME, all have a Command Prompt utility which 
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opens a window offering nearly all of the capabilities of the original DOS, 
by emulating the original operating system. Not all functions are fully com- 
patible, however; for example, there are frequently problems with timing 
and delays. These aspects will be covered in more detail in the next chap- 
ter. Operating systems designed for multiple users, such as Windows NT, 
which are more security conscious, do not offer full DOS compatibility, 
and direct access to the hardware, even via what appear to be DOS inter- 
rupt calls, is not available. 


Linux 

Linux is free software. But, just because it’s free, doesn’t necessarily mean 
it’s free. Think ‘free’ as in ‘free speech’, not ‘free beer’. In a nutshell, soft- 
ware that is free as in speech, like Linux, is distributed along with its source 
code so that anyone who receives it is free to make changes and redistribute 
it. So, not only is it permitted to make copies of Linux and give them to 
your friends, it’s also fine to tweak a few lines of the source code while 
youre at it — as long as you also freely provide your modified source code 
to everyone else. To learn more about free software and the major software 
licence it is distributed under, called the General Public License (GPL), look 
at the Linux website. In addition to the GPL, there are many other software 
licences that allow you to modify the source code. The Open Source Initia- 
tive approves these licences and keeps a current list of them. 

Linux is not owned by anyone. One misconception many first-time 
www.linux.com readers have is that this site is similar to www.microsoft.com, 
which is owned and controlled by the company that produces the Win- 
dows operating system. * 

Not so. No one company or individual ‘owns’ Linux, which was devel- 
oped, and is still being improved, by thousands of corporate-supported and 
volunteer programmers all over the world. Not even Linus Torvalds, who 
started the Linux ball rolling in 1991, ‘owns’ Linux. 

(However, the trademark ‘Linux’ is owned by Linus Torvalds, so if you 
call something ‘Linux’ it had better be Linux, not something else.) 


How to get Linux 
When you ‘get Linux’ you are usually getting a Linux distribution that con- 
__ tains not only the basic Linux operating system, but also programs that 
enhance it in many ways. Anyone who wants to put together their own 
Linux distribution is free to do so, and there are more than 200 different 
Linux distributions that fill special niche purposes. But new users are ad- 
vised to stick with one of the five or six most popular general-purpose Linux 
distributions until they know a little about what Linux can and can’t do. 

Linux is available from a number of online software repositories, includ- 
ing the official websites for each distribution. For example, at www.linux- 
mandrake.com you'll find the Mandrake distribution; at www.redhat.com 
you'll find Red Hat Linux. 

It helps to have a fast connection and a CD writer so you can quickly 
download an ISO image of the distribution and write it onto a CD. You 
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then can load the bootable installation programs that lead you, step by step, 
through the process of getting Linux on your computer. 

If you don’t have a CD writer, you'll be better off if you buy a CD pre- 
loaded with the distribution (or distributions) of your choice. The more 
popular distributions are available in many computer stores and directly 
from each distribution’s publisher. They sell full boxed sets of CDs or DVDs 
that come complete with a fancy user manual and official technical sup- 
port. The average price is $25 to $80 USD. The convenience of a distribu- 
tion on CDs, including manuals, generally makes your first installation so 
much easier that it is well worth the money, and even if you pay full retail 
price for a Linux distribution you will still get an incredible value. 


Applications software 


This can usually be taken to mean commercially produced software pack- 
ages, available from computer software vendors, as well as public domain 
and shareware packages available for little or no cost. Public domain soft- 
ware is usually written by individuals in their spare time and offered free of 
charge to anyone who wants to use it. It is usually provided as is, with often 
little follow-up support or documentation. There is a huge amount of pub- 
lic domain software available for the radio amateur, providing facilities as 
widely spaced as terrain plotting for radio propagation calculations, ad- 
vanced data modes for radio communications and RF design. These days 
the easiest way to get just about any software package is via the web. Typ- 
ing a few keywords into a search engine such as Google will usually throw 
‘up enough pointers to find a site from which software can be found. 

Shareware software operates on a slightly more formalised principle with 
regard to payment, and in turn follow-up support. Here the software is ini- 
tially obtained and run free of charge. Subsequently, if the user finds it 
satisfactory a payment is made to the author. Often this is voluntary and 
based on goodwill and a ‘warm feeling of support’. In many cases, after 
payment has been received, further enhancements to the software may be 
provided, such as extra help files, increased functionality or the removal of 
pop-up messages saying how you should really be paying for using this 
software! 

The third type of software is, of course, the commercial package or suite 
which will come with full support, documentation and a guarantee. A browse 
around any of the high street computer outlets or computer magazines will 
show the vast range available for just about any specialised task. 


Spreadsheets for manipulating and plotting results 

One of the more popular types of software run on many home computers is 
the spreadsheet, of which probably the most popular these days is Microsoft 
Excel, supplied as part of the Microsoft Office suite. Apart from the usual 
spreadsheet functions, such as the ability to make multiple calculations 
across rows and columns of data, Excel has a capability of reading in external 
data from files in a wide variety of formats. In practice, in order to import 
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Microsoft Excel - FigiD1_xls 


fi|Measurement interval 1 minute 
__ Voltage! 
Bp Os Retna We 
12.51 Open cet. 


AGt HOH 24-1 QAte 22e4 
Minutes 


| 12.03  foniy the first 20 tines of data are sh 
' 42.03, | 


+ 
Fig1.1.Exampleofa such data, the file containing the information to be plotted should be 
graph of results, preferably stored as a text file. When in Excel, open this file as normal and 
generated by read- 5 tao? 
ing a separately follow the on-screen prompts with regard to format and delimiters. Once 
stored results file data has been read in satisfactorily, it can be processed and used to give a 
WS Pasha wide variety of graphical plots. Thus this single piece of software can be used 
as a back-end for displaying results from tests and measurements on just 
about anything we may wish. The only requirement is that the measured 
results, taking the form, for example, of a voltage changing over time, can be 
saved in a file on the computer in a form that can be subsequently read into 
Excel. 

A suitable add-on accessory for making automatic readings of a voltage 
over time and saving to a file on disc is the HF-08 data logger, described in 
Chapter 5. 

Fig 1.1 shows the spreadsheet used to plot the voltage of a fully charged 
20Ah lead-acid battery powering a 50W halogen bulb. The battery voltage 
was divided by seven in a potential divider and fed to the HF-08 set to 
measure 0 to 2.5V full-scale, and output text format data each minute. Us- 
ing the Hypertrm software supplied with Windows, the data from the HF- 
08 was saved to a .TXT file which was subsequently read into Excel. The 
left-hand column is the raw reading from the HF-08. With a full-scale range 
of 17.5V (2.5V full-scale x 7 in the potential divider) the actual battery | 
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voltage is derived from the 0 to 255 reading (N) supplied by the data logger 
as follows: 


Battery voltage = N/256 x 2.5 x 7 


This forms the second column of the spreadsheet. The graph is produced 
by highlighting the figures to be plotted, following the on-screen ‘wizard’ 
for producing a chart. 


Programming the PC 


The other option is to write your own software. In the early days of home 
computers this was often the only way to use these machines, and all users 
became quite fluent in programming languages. These days, with the vast 
amount of software available, it is quite possible to manage without having 
to do any formal programming, other than generating spreadsheets. 

However, by learning how to write your own software it is possible to 
unleash the maximum power, speed and performance of your computer to 
do just what you want, how you want it. Furthermore, there can be the 
satisfaction of making this available to others as public domain software, or 
earning some money from it by offering as shareware or selling it commer- 
cially. 

To programme a computer, it is first necessary to choose a language in 
which to write the software. There are a limited number of languages in use 
these days, and each has its adherents who rigorously defend ‘their’ choice 
and state how much better it is than any other rival computer language. 
Needless to say, all have their advantages and disadvantages and arguably, 
they all provide a roughly similar performance in the finished product. 

In the early days of computing the Basic language was all encompassing, 
with as many incompatible dialects as there were types of home computer. 
These days two dialects of Basic have survived the test of time, both reason- 
ably compatible with each other. For writing simple applications for the 
Windows operating system, Microsoft’s Visual Basic is very popular with 
its ability to easily generate a Windows user interface for inputting data and 
displaying the results. However, it is not very fast compared with other 
languages and is not well suited to real-time, high-speed processing or serv- 
icing external interfaces. The first versions of Basic, such as GW Basic which 
was supplied with DOS machines, were even slower as they operated as an 
interpreted language, reading, decoding and executing each line of soft- 
ware as it ran, rather than converting the whole programme into native 
machine code in the most efficient way, then running this at maximum 
speed. 

One other surviving dialect of Basic, and the author’s preferred language, 
is Power Basic. In fact there are two primary versions of this in use, one for 
writing the full-performance 32-bit Windows applications, and a 16-bit ver- 
sion for DOS-based operating systems, which can also run in a Command 
Prompt window [2]. The 16-bit Microsoft equivalent version, the predeces- 
sor to Visual Basic for DOS, is called QuickBasic. 
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Table 1.1. Example of a typical computer programme written in a high- 
level language 


INPUT "Enter a number between 0 and 9" , n% 
IF n% < 0 OR n% >9 THEN 
PRINT “Error, number out of range” 


BEEP 

ELSE : 
PRINT "Value entered OK" 
EXIT LOOP 

END IF 


| LOOP 
| n% = n% * 12 + 32 
m= 10 * LOG10(n%) 

; PRINT "Result ";n%; 

| PRINT USING “##.#dB";m 
| END 


Early versions of Basic did not encourage proper software writing prac- 
tice and so this language was often sneered at by the professionals for not 
being capable of generating proper software and encouraging poor pro- 
gramming technique. The modern variants do indeed allow proper pro- 
gramming techniques to be used, such as local variables, variable declara- 
tions and procedures, although their use is not compulsory; older ‘legacy’ 
functions such as subroutines are still available for those who insist on using 
them. Early dialects of Basic required every line to be preceded by a line 
number but the latest versions have removed this limitation and Basic list- 
ings in this book do not show any line numbering. * 

Probably the widest used, and most versatile, programming language is 
C and its more advanced variants, C+ and C++. This is certainly the lan- 
guage of choice for most professional purposes and many amateurs use it 
too. However, programmes written in C are often more cryptic and diffi- 
cult to understand (except by a C programmer) than Basic. When supported 
by plenty of comments and sensible variable names, Basic is a lot more self- 
explanatory; except possibly, to C programmers! An example of a pro- 
gramme written in Power Basic is shown in Table 1.1 and its C equivalent 
in Table 1.2. 

This simple programme makes use of some of the features of Power Ba- 
sic and QuickBasic. It requests the user for a number between 0 and 9, 
checks it for validity and, if an error has been made in entry, prompts the 
user to correct the error. The number is processed and an answer returned. 

Basic does not require any variables to be declared, so we can jump right 
into the programme at the first line, DO, which sets up a repeated loop. The 
next line requests the user to enter a number — the text between quotes is 
printed to the screen telling the user what is wanted. The user now types in 
a value and presses Enter. The number typed in is now stored in the vari- 
able n% within the programme. The ‘%’ means that the variable type is an 
short integer, ie it stores whole numbers only between the range —32768 to 
+32767 using 16 bits or two eight-bit memory locations to store each value. 


Table 1.2. The same programme written in the C computer language 


#include <stdio.h> /* for IO functions */ 
#include <math.h> /* for math routines */ 


t 


#define BEEP 0x07 /* ascii character fo a beep */ 
#define TRUE 1 
#define FALSE 0 


void main(void); /* declaration of main() */ 


void main(void) 


{ 


| 3 


j 
| 
i 
i 
i 
| 
/* definition of mainQ) */ 
| 
| 
| 
: 


int n; 
float m; 


/* start inifnite loop, anything */ 
/* greater than zero is a positive test */ 
do 
{ 
/* read a number from console */ 
scanf("%d" ,&n) ; 
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/* if not in range 0 to 9 print an error */ 


ifC(n<0) || Cn>9)) 


{ 
printf("Error, number out of range\n%c",BEEP); 
} 
else 
{ 
/* if number between 0 and 9 break loop */ 
printfC"Value entered OK\n"); 
break; 
} 


swhileC(TRUE); /* always test positive */ 


/* do calculations */ 

/* log10Q returns double precision */ 

/* so cast it to a float (single precision) */ 
n=n*12+32; 

m=10.0* (float) 1log10(n) ; 


/* print results %d == integer \t =tab */ 

/* %3.1f = 3 sig fig with one decimal place */ 
/® \n = <cr><1f>*/ 

printfC"Result %d\t%3.1fdB\n",n,m) ; 


The next line tests the value of n% and, if it is less than 0 or more than 9, 


executes the instructions listed before the ELSE statement. It first prompts the 
user that the value entered is out of range by printing an error message (the 
text enclosed between the quotes) to the screen. It then sends a beep sound 
to the PC speaker. If the value does not meet the test criteria, the statements 
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between the ELSE and END IF commands are executed, here prompting the 
user than the value is correct, then jumping out of the DO loop to continue 
with the rest of the programme. The END IF statement is needed to complete 
the IF statement. An error will be generated when the programme is 
compiled and run if no corresponding END. . . statement is present. 

The LOOP terminates the initial DO statement. LOOP UNTIL and LOOP 
WHILE are also possible here, giving conditional branches — their meanings 
should be self-explanatory. DO UNTIL and DO WHILE are also allowed, so 
considerable versatility is possible in setting up loop structures. The next 
line replaces the value of n% with a multiplied and incremented version of 
its original value. 

The next line introduces a new variable m. Since it has no suffix it adopts 
the default type of a single-precision floating point number, which can take 
on any value between approximately +10~** to 10°* to an accuracy of about 
six decimal places. It calculates 10 times the log to the base 10 of n% (its 
values in decibels). 

The next line informs the user that the result is n% and the semicolon at 
the end of the line is important. It prevents the printout from dropping to 
the next line after printing the value of n% so that the next statement to be 
printed follows straight on the same line. 

The next statement makes use of formatted printing. The value of m as 
calculated here could have any value from 10.3885 to 20.5308, but we don’t 
need to be told the exact value, so the formatted printing statement forces 
the output to take on the format of two digits preceding the decimal point 
followed by one after it, taking into account any rounding needed. The 
values printed to the screen will look like 10.4dB to 20.5dB. 

On reaching the last END statement the programme will terminate; in a 
DOS or command prompt environment it will return to the operating 
system. The END statement is not compulsory in Basic but allows a tidier 
listing. 

The equivalent one-for-one C language listing is given in Table 1.2. Any 
text between /* ... */ are comments or explanations; they are not part 
of the C code and are ignored by the compiler. 

Most programmes in this book written for the PC are in 16-bit Power 
Basic for DOS, or more usually these days for running within the Com- 


- mand Prompt — as that is my language of choice. In many cases they can be 


converted to QuickBasic with minimal changes to syntax. Conversion to 
the Windows versions will involve re-writing all the input and output rou- 
tines to suit the graphical user interface, but the core of the software, the bit 
that does the real work, can usually remain as it is, with the considerable 
speed advantage of being able to use the full 32-bit processing capability. 

It is usually quite straightforward to convert from one language into an- 
other. Frequently one-for-one translation of each line of software is possi- 
ble; if not, the author making the translation will know only too well how to 
do the job in their own language of choice. 

Alternative programming languages are Pascal, and its Windows pro- 
gramming variant Delphi, which are still used by some adherents; as well 
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Representations of numbers within computers 


Since all numerical values associated with digital machines are multiples of 2, 
_ expressing numbers in the normal decimal way is not very helpful. Instead, 
numbers are expressed to base 16 and the letters ‘A’ to ‘F are introduced to 
represent the values (in decimal) of 10 through to 15. By convention, such 
hexadecimal numbers are usually shown as being preceded by ‘Ox’, and this is the | 
terminology used throughout the text within this book, it is also the format | 
required in the C programming language. Basic, however, requires that hexadeci- 
mal numbers be preceded by ‘&h’, and this appears in the listings. | 
A byte can now be expressed by using two characters, each one representing | 
four of its bits. Some examples are: | 


Decimal value Hexrepresentation _Binary 


1 0x01 00000001 
12 Ox0A 00001100 | 
64 0x20 01000000 | 
a3 Ox67 01100111 | 
245 OXF5 11110101 
255 OXFF 11111111 


This can be logically extended to 16-bit (and higher) values : 


: 1000 Ox03E8 0000001111101000 
13457 0x3491 0011010010010001 
49152 0xC000 1100000000000000 


Binary coded decimal (BCD) is a sort of half-way house. The individual digits of a 
decimal number are represented in groups of four bits, each group representing | 
the binary equivalent of its associated digit. Digits are often paired up so thata byte | 
now represents two digits — this representation being called packed BCD. | 


Decimal value Hexrepresentation _ Binary 
23 0x23 0010 0011 
127: 0x127 0001 0010 0111 


BCD representation is frequently used within microcontroller programming to | 
simplify interfacing to keyboards and simple displays. ) 


as older languages such as Fortran and Cobol which do show up occasion- 
ally in various older ‘legacy’ software. 


Variables and their representation 
An area that often causes confusion amongst those new to computer pro- 
gramming is understanding how real-world data is stored in binary form, 
and the many different variable types that are available to programmers. A 
computer has to be able to store whatever type of user data is required for 
processing and this usually consists of numbers for mathematical manipu- 
lation, or text. Most data falls into one of these two categories. 

All computers store data in ‘words’ consisting of a fixed number of bi- 
nary bits per word. The word length is usually the width of the computer’s 
data bus, as described earlier when the processing power of a computer was 
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discussed. Word lengths in common use extend from eight bits for the very 
simplest microprocessors, then 16 bits for the first- and second-generation 
PCs, through to 32 bits for later machines, while the very latest PCs make 
use of a 64-bit bus and equivalent word length. Some digital signal process- 
ing chips use a 24-bit wide bus, with parts of the processing doubling this 
up to 48 bits. 


The byte 

The most fundamental item of data seen in any computer is the byte, con- 
sisting of eight bits, with all the word sizes given above being simple multi- 
ples of one byte. In fact, the byte is such a fundamental concept in comput- 
ing that all memory sizes and much addressing of memory is defined in 
terms of bytes rather than the actual word length. A 16-bit machine has a 
bus width of two bytes, a 32-bit machine four bytes and so on. Memory size 
is defined in bytes, and in practice many memory chips have a physical 
width of eight bits so they have to be paralleled for greater width. 


Text and characters 

Letters, number and punctuation, together with print control codes such as 
carriage return, page feed etc, are often stored in the American Standard Code 
for Information Interchange (ASCII) representation as shown in Table 1.3. Of 
the 256 values possible in the eight bits making up a byte, the first 128 are _ 
allocated to all the standard control codes, numbers, letters and punctua- 
tion/procedural symbols. The remaining 128 characters are not rigorously 
defined and different countries have adopted some for their international 
characters, while other values are given over to blocks and shapes, or small 
drawing symbols. Within a PC the allocation of symbols to the byte values 
is defined in the country set-up information. 

Within the PC, and most other computers, text is simply stored as a se- 
quence of ASCII symbols, and such a set of characters is usually referred to 
as a text string — a string of characters. Where word length is greater than 
one byte, the characters are stored two, or more, per word. For example, a 
32-bit machine would hold four symbols per word and the addressing needs 
to take this into account when trying to access any particular symbol. In 
many situations, it is necessary to know how long the string is in memory; 


- one string may be a sentence or paragraph, for example. 


There are two ways of delimiting strings. The first is to maintain a sepa- 
rate index table of the text, so in order to access the data the computer first 
looks at the index, then extracts the appropriate number of bytes from the 
correct memory locations. This is fine when a complex piece of software, 


- such as a word processor, needs to continually keep track of arbitrary data, 


but for less-frequent text storage it is not very efficient to continually main- 
tain a separate index table. The alternative used in many computer lan- 
guages is the null-terminated string where the ASCII control character zero, 
given the descriptor NUL, is appended to the end of each string. Then to 
extract the complete set of bytes, the computer starts at the beginning of the 
data and works through it until the NUL character is detected. This process 


Table 1.3. ASCII symbols 


| 000 
/ 001 
| 002 
' 003 
/ 004 
| 005 
| 006 
| 007 
| 008 
/ 009 
| 010 
011 
| 012 
; 
: 
; 
} 
| 
| 
| 
; 


| 013 


/ 014 
' 015 
| 016 
017 
| 018 
| 019 
' 020 
| 021 

022 
| 023 
024 
| 025 
| 026 
| 027 
| 028 
029 
| 030 


031 
032 
033 
034 
035 
036 
037 
038 
039 
040 
041 
042 
043 
044 
045 
046 
047 
048 
049 
050 
051 


001 
002 
003 
004 
005 
006 
007 
010 
011 
012 
013 
014 
015 
016 
017 
020 
021 
022 
023 
024 
025 
026 
027 
030 
031 
032 
033 
034 
035 
036 


037 
040 
041 
042 
043 
044 
045 
046 
047 
050 
051 
052 
053 
054 
055 
056 
057 
060 
061 
062 
063 


000 


000 
001 
002 
003 
904 
005 
006 
007 
008 
009 
OOA 
00B 
00C 
00D 
OOE 
OOF 

010 
011 

012 
013 
014 
015 
016 
017 
018 
019 
O1A 
01B 
O1C 
01D 
O1E 


O1F 
020 
021 
022 
023 
024 
025 
026 
027 
028 
029 
02A 
02B 
02C 
02D 
02E 
02F 
030 
031 
032 
033 


00000000 


00000001 
00000010 
00000011 
00000100 
00000101 
00000110 
00000111 
00001000 
00001001 
00001010 
00001011 
00001100 
00001101 
00001110 
00001111 
00010000 
00010001 
00010010 
00010011 
00010100 
00010101 
00010110 
00010111 
00011000 
00011001 
00011010 
00011011 
00011100 
00011101 
00011110 


00011111 
00100000 
00100001 
00100010 
00100011 
00100100 
00100101 
00100110 
00100111 
00101000 
00101001 
00101010 
00101011 
00101100 
00101101 
00101110 
00101111 
00110000 
00110001 
00110010 
00110011 


DC1 XON 
DC2 

DC3 XOFF 
DC4 

NAK 

SYN 


/ 
0 
1 
2 
3 
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SIDES ES OS 
Null character 
Start of Header 

Start of Text 

End of Text 

End of Transmission 
Enquiry 
Acknowledgment 

Bell 

Backspace 

Horizontal Tab 

Line Feed 

Vertical Tab 

Form Feed 

Carriage Return 

Shift Out 

Shift In 

Data Link Escape 

Device Control 1 

Device Control 2 

Device Control 3 

Device Control 4 
Negative Acknowledgement 
Synchronous Idle 

End of Trans. Block 
Cancel 

End of Medium 
Substitute 

Escape 

File Separator 

Group Separator 
Request to SendRecord 
Separator 

Unit Separator 

Space 

Exclamation mark 
Double quote 

Number sign 

Dollar sign 

Percent 

Ampersand 

Single quote 
Left/opening parenthesis 
right/closing parenthesis 
Asterisk 

Plus 

Single quote 

Minus or dash 

Dot 

Forward slash 


| PERS ee anand Ue ae 
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052 064 034 00110100 4 
053 065 0357, 00110101 25 
054 066 036 00110110 6 
055 067 037) 00TIO TNE 7, 
056 070 038 00111000 8 
| 057 071 039 00111001 9 
058 072 O3A 00111010 =: Colon 
059 073 OSB: -OOTTTOIA Semi-colon 
060 074 0365700111100; < Less than 
061 075 03D 00111101 = Equal sign 
062 076 O3EC | O01 11110) > Greater than 
063 077 O3F 2. 00TT TI 22 Question mark 
064 100 040 01000000 @ At symbol 
065 101 041 01000001 A 
066 102 042 01000010 B 
067 103 043 01000011 C 
068 104 044 01000100 OD 
069 105 045 01000101 E 
070 106 046 01000110 F 
071 107 047 01000111 G 
072 110 048 01001000 H 
| 073 11 049 01001001 | 
| 074 112 04A 01001010 J 
075 143 04B 01001011 K 
076 114 04C 01001100 L 
077 TEAS: 04D 01001101 M 
078 116 O4E 01001110 N 
079 117 O4E-¢ 201001111240 * 
080 120 050 01010000 P 
081 121 051 01010001 Q 
082 a22 052°*.301010010°- R 
083 123 053 01010011 S§S 
084 124 054 01010100 T 
085 125 055 01010101 U 
086 126 056 01010110 V 
087 127: 0572 O10TOT A: = W 
088 130 058 01011000 xX 
089 len 059° 01011001 --Y. 
090 132 O5A 01011010 Z 
091 133 O5B 01011011 | Left/opening bracket 
092 134 05C 01011100 \ Back slash 
093 35 05Dac OTOTTLOT 4 Right/closing bracket 
094 136 O5E OLOT1 LTO: 4 Caret/cirumflex 
| 095 aa hsiy/ O5F OLOM Wada Underscore 
| 096 140 060 01100000 - 
| 097 141 061 01100001 a 
| 098 142 062 01100010 b 
| 099 143 063° <= 01700011: ..c 
/ 100 144 064 01100100 d 
| 101 145 065 01100101 e 
| 102 146 066 01100110 f 
| 103 147 067. OTIO0OI11 2 
| 104 150 068 01101000 h 
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Table 1.3 (continued) 


105 151 069 01101001 


I j 
106 152. O6A 01101010 j | 
107 153. O6B 01101011. k | 
108 154° 06C. (01101100. | | 
109 155 O6D 01101101 m 
|410-°% 156 ~~ O6E 01101110 on | 
111 57 O6F <2 01101111 0 ) 
112 160 070 01110000 p 
113 161 071 01110001 gq | 
114. 9 :3624:1.072.15 01110010; < t | 
115 163. 073... 01110011. s ) 
116 164 074 01110100 ¢t | 
ity 165 O75 01110101 u 
| 118 166 076 01110110 v | 
| 119 $67) (07701110111 -w 
| 120 170 078 01111000 x | 
eo Paige 171) O79" OF1T TOOT” | 
122 172°? OFA’ * 01171010" *z | 
123 173.078: 01111011 > -{ Left/opening brace | 
124 474<.° O7C.. 01111100. | Vertical bar ) 
| 125 175 07D) OTL TIIOT Ts: } Right/closing brace 
| 126 176" A O7E 4 O11T H10ie# Tilde 


1127 7: OFF iy | O14 VET. DEL Delete 


is a bit slower as each character has to be checked as it is extracted, but is 
more versatile. 

The Windows operating system abandons eight-bit ASCII data to give 
more flexibility in the number of characters that are available. Internal rep- 
resentation of each character is now by 16 bits, or two bytes, in a character 
set called Unicode, giving 65536 different symbols. This is more than enough 
to cover all international and procedural characters, with scope for future 
expansion. 


Representation of numbers in binary 

Within the constraints imposed by the fundamental word length defined by 
the processor, we need to be able to store numbers in a way that makes best 
use of computer memory. The types of numbers needed to be dealt with 
vary from simple positive numbers such as 1, 200 etc to negative numbers 
and fractional values. In the latter case of fractional numbers, what accu- 
racy do we need? Is five decimal places good enough or do we need to be 
able to store numbers to 14 significant figures? To address these different 
requirements a number of different variable types are in use. 

The simplest numbers to visualise are single-byte integers — the eight bits 
simply represent the values from 0 to 255. This variable type is not often 
needed — eight bit values are more usually associated with their ASCII char- 
acter representation, but the BYTE variable is available in a number of 
computer languages. 
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The next is the short integer, which takes two bytes or 16 bits. This can 
represent all whole numbers from 0 to 65535 and the short unsigned inte- 
ger (SHORT UINT) is available as a variable type in most languages. But 
in practice the short integer value is modified to allow for the storage and 
manipulation of negative numbers, and now we need to consider how nega- 
tive numbers are represented. 


Negative numbers 
One method is allocate one bit as the sign bit to indicate whether the value 
is above or below zero. Then the other 15 bits make up the value of the 
number from zero to 16383. We can see that there is now an ambiguity as 
there are two correct values for zero, +0 and —-0. Mathematics does not like 
this ambiguity and another way of representing negative numbers is needed. 
The answer is in a system called two’s complement. Now the allocation of 
bits within the word is altered slightly. The most-significant bit is allocated 
the value of minus its unsigned value, with the other bit allocations un- 
changed. So the bit values making up a 16-bit number are now: 


—32788, +16384, +8192, +4096, +2048, +1024, +512, +256, +128, +64, 
+32,+16, +8, +4, +2, +1 


The 16-bit binary value is unchanged if the most significant bit is a zero, but 
if this is set the effect of adding the remaining bits to -32788 gives a nega- 
tive number that can range from —32768 to —1. Some two’s complement 16- 
bit numbers are illustrated: 


1000 0000 0000 0011 = -32768 + 3 —327605 
1110 0000 0000 0000 = -—32768 + 16384+ 8192 = -—§192 
1111 0100 1010 1100 = -—32768 + 16384 + 8192 + 

4096 + 1024 + 128+ 


32+8+4 = -—2900 
1111 1111 1111 1111 = -32768 + 16384 + 

81025 ras = -l 
LULT Ef iit 0000 = -16 


From the above, it can be seen that there is only one value for zero and a 
positive value can be negated by subtracting one from its value, then in- 
verting the bits. Two’s complement values work automatically in addition 


~ routines, which is where the real value of this representation comes about 


as shown: 


-3000 11110100 0100 1000 
+100 0000 0000 0110 0100 


—2900 11110100 1010 1100 


The short integer variable type (SHORT) is one of the most commonly 
used variables within computer programmes, frequently used for counters 
and data pointers. 

For larger integers the long integer (LONG) is adopted, which uses four 
bytes or 32 bits in two’s complement representation, allowing numbers from 
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-2147483648 to 2147483647 to be represented. In unsigned form, values 
up to 4294967296 can be represented and this is the limit of address space 
in the PC with its 32-bit wide address bus. 

QUAD integers (64 bits or eight bytes) are possible in some languages 
and, similarly, can be either signed or unsigned. 


Floating point numbers 
Integers are fine if we want to represent whole numbers exactly, but what 
about pi (3.141592653589793 etc) or -1.2? 

The technique used for representation of fractional numbers is to use a 
binary version of the exponential notation often encountered in scientific 
work, eg 12345 = 1.2345 x 10° where the ‘1.2345’ part is called the mantissa, 
and the ‘5’ the power of ten, or the exponent. 

32 bits are taken to represent each single-precision number (abbreviated 
to variable type SINGLE) and these are allocated as follows. 

Bits 0 to 22 represent the mantissa, giving values that can range from 0 to 
a little over 8 million but normalised by dividing by 2”? so it represents a 
fractional value between 0 and a value just under 1. 

Eight bits represent the binary exponent in two’s complement format, so 
that it can take on any value from 278 to 2*!”’. This represents approxi- 
mately the range 10~** to 10°. 

The remaining most-significant bit forms a sign bit for the result, two’s 
complement representation not being practical for the mantissa. Thus float- 
ing point numbers can be stored that range from approximately + 5.9 x 
10-*° to +6.8 x 10% to a precision of around six decimal places. The IEEE 
standard reduces this range slightly to free up bit patterns that are allocated 
special meanings, and the range is reduced to +3.4 x 10°8 and +1.2 x 10° 
respectively. The freed-up codes allow certain error conditions to be stored, 
such as the Not A Number (NAN) situation available in many languages 
where incorrect programming mixes up numerical and textual data. 

If a greater accuracy or a wider numerical range is desired, the double- 
precision (DOUBLE) type variable is available which uses eight bytes and 
allows numbers from +2.2 x 10° to +1.8 x 10°°8 to approximately 16 deci- 
mal digits of accuracy. 

So we now have the variable types: 


CHAR Character used for text etc, and usually in the 
form of a null-terminated string 

SHORT (Integer is understood) 

UNSIGNED SHORT 

LONG 

UNSIGNED LONG 

QUAD 

SINGLE (Floating point is understood) 

DOUBLE 


Confusion often reigns when converting some programmes between ma- 
chines and languages, as most computer languages allow the variable type 
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just called ‘INT’ or integer. Once this always meant a 16-bit integer, and 
LONG was used for a 32-bit integer when needed. However, with the ad- 
vent of 32-bit machines running the Windows operating system, program- 
ming languages targeted at these often use the INT variable to represent 
one word’s worth of storage, or what was once a LONG integer. This can 
cause catastrophic problems when transferring from one older version of a 
language to a later one as memory allocation of the variables gets com- 
pletely lost. The safest way to avoid such problems is to avoid the INT type 
declaration altogether and just refer to all integer variables as SHORT or 
LONG. No such problems arise with floating point numbers, although the 
variable type FLOAT is allowed, and is equivalent to the SINGLE variable 


type only. 


Variable declarations 

The majority of computer languages require that all variables used in a 
programme be declared before they are first used. This is so that the com- 
piler can allocate storage in memory in advance. If an attempt is made to 
use a variable that has not been declared, an error message informs the user 
of this when the programme is first run. The one exception to this is the 
Basic programming language where the variable type is implicit in its name; 
this done by appending a single character to the end of the name to define 
the type. For example COUNTER% and Number_Of_People% are both 
short integers, while Cost! and PI! are single-precision floating point. While 
not having to declare variables before use has its advantages when writing 
and debugging code, many programmers frown on the practice as it allows 
sloppy programming practice and allows through unwanted vagiables cre- 
ated by undetected typing errors — all modern variants of Basic now allow 
variables to be declared if desired. 


Crashes, recovery and data security 


Everyone has heard of or had a computer crash, where some event occurs 
that locks up the whole machine, preventing any keyboard or mouse ac- 
cess. The only solution is to completely reset the computer, which loses any 
data that is currently being worked on. On the older PCs running DOS, it 
- was easy to cause a machine crash as various parts of memory and input/ 
output space being used by the operating system were fully accessible to 
programmers. So by accidentally accessing the wrong location, which can 
be done as simply as allowing an array to overflow without checking, or 
specifying an incorrect I/O address, a major crash could occur - most DOS 
~ crashes were not recoverable and needed a reboot. 

From the Windows 95 operating system onwards this is less of a prob- 
lem. Now the OS runs in what is referred to as Protected Mode, where it is 
now theoretically impossible to get at areas of memory other than those 
specifically allocated to the specific window or task under consideration. It 
is also made more difficult to directly access the computer hardware and it 
is this very part of the Windows OS that makes it of less value for many of 
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our purposes since we often would like to use the I/O facilities in non- 
standard (and potentially dangerous) ways. It is still possible to crash a task 
running under Windows, but now a Ctrl-Alt-Del sequence is usually all that 
is needed to close the current task. Any data currently being processed is 
still lost, but the computer does not have to be restarted — just the task that 
caused the problem. Complete operating system crashes can still occur from 
time to time, but these are rarer and more often than not are due to older 
versions of operating systems being employed with modern software, or 
PC hardware incompatibility problems. 


Backing up 

Whatever operating system is in use, there is always the possibility of loss of 
current data, and if the hard disc crashes or is damaged a lot of valuable 
data can be lost. So periodic saving and backing up of data is strongly ad- 
visable. In the event of disc crashes, there are two areas of data that need to 
be considered. The first is the software itself. For modern operating sys- 
tems, this usually has to be completely reinstalled — often from a CD-ROM, 
but the installation process is straightforward enough. The second is the 
user data — word processed documents, for example, or personally written 
software which has to be saved independently on another medium such as 
a floppy disc, re-writable CD-ROM or a second hard disc. 

However, there are precautions that, as writers of software, we can build 
into our programmes to make their operation survive a crash. Take as an 
example a piece of software that requires the user to type in a lot of data for 
processing — such as a contest-scoring programme. The easiest way is often 
to hold the data in memory as it is typed in and processed, then dump to 
disc at the end or whenever required. An alternative is to keep a disc file 
open and write each item of data to the file as it appears. This approach can 
be fatal —- as the author once discovered when writing just such a scoring 
programme! All memory contents are lost when power is lost or the com- 
puter has to be rebooted following a crash, so all the data that was entered 
is now lost. Maintaining an open file has similar problems. Until a file is 
closed, some of the data that is to be written to is held in the operating 
system’s memory, and only written to disc when this is full — furthermore 
the disc header information, or index, is not updated until the file is closed. 
So a crash while a file is open will often lead to this file being corrupted and 
the data not recoverable. The correct programming procedure to allow for 
this eventuality is to only open the file when the new data is to be written, 
then close it immediately afterwards. Then the most that can be lost is the 
one data item being processed at the time of the crash. Most contest scoring 
programmes are now written this way — during /P operation generators 
often fail and the laptop’s batteries are usually dead too! There is still the 
remote possibility that a crash could occur during the time the file is open 
and, to counter even this remote eventuality, tricks could be employed such 
as writing to alternate files so that only one file is open at a time or making 
a complete file copy each time a new item is written. 

It is impossible to give any general rules about how to make software as 
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? DH3MKL de EUIAZ 


AZ de DH3MKL == EU1AZ de DH3MKL == dear radiofriend Al 


iam rejoice of you coming and | am 74 years old . My qth is Mindelheim in Bavaria, south Germany 
with the locator JNS58FB. (10 grad,29 min,43 sek East and 48 grad, 03 min, 01 sek north.) 

Here my toys. my shak = 
== TAX is YAESU 767 GX 

== Antenna Groundplan 4 Bands tuned with ext. MFJ VERSA Tuner. 
== Computer AMD neste ttt 


Fig 1.2. Digipan user 
interface. Note the 
waterfall plot show- 
ing the _ large 
number of stations 
using PSK31 on the 
14MHz band on a 
Sunday afternoon 


20 


fail-safe as possible, but if a computer crash would cause excessive prob- 
lems it is always worth thinking about what facilities can be built into your 
software to mitigate the inevitable. If it can happen, some day it will. 


Data modes 


An area that has grown recently with the increased computing power now 
available is that of data modes. All modern PCs include a sound card, a 
piece of hardware that converts computer data to audio and vice-versa via 
high-quality digital-to-analogue (D/A) and analogue-to-digital (A/D) con- 
verters. Other features are usually offered too, such as music synthesis, but 
these are unlikely to be needed for any amateur radio purposes. The idea 
behind the modern data modes is to use the A/D and D/A conversion 
facilities on the sound card to allow software to work mathematically on 
actual samples of audio, and do the necessary processing on these to func- 
tion as modems, data converters, or whatever is necessary for digital 
communication. ; 

The software for this specific type of processing is usually referred to as 
digital signal processing (DSP) and is covered in more detail in Chapter 8. It is 
not the intention in this book to go into data modes in any detail, as these 
are covered comprehensively in reference [3]. The use of the sound card as 
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[1 Scan Input 


an input/output port, with circuitry to interface to external equipment, is 
covered in Chapter 10. 

Typical software for data modes usually presents a user interface which 
includes a window for showing the decoded received text, another window 
for typing in text to be sent and a variety of controls such as sliders and 
buttons for setting up the correct operation of the software. Apart from the 
audio sound card interface, the software usually controls transmit/receive 
switching of a transceiver, and occasionally receiver tuning on those able to 
accept remote control. 

Fig 1.2 shows the user interface for the DIGIPAN software written by 
KHOTY et al, for transmitting and receiving PSK31, a narrow-bandwidth, 
keyboard-to-keyboard chat mode using phase-shift keying. The mode was 
originally invented by G3PLX in an attempt to find a modern replacement 
for RTTY. 

Fig 3.14 in Chapter 3 is the user screen of PCALE by G4GUO which is 
designed for automatic link establishment at HF, implementing the MIL 
Standard 188-141A signalling protocol. This software scans a number of pre- 
programmed HF channels for a special probe signal from specified users, 
looking for channels where paths may be open. It also transmits its own 
probe signals, and all stations taking part in the net are able to maintain a list 
of frequencies and the path quality between themselves so that when a 
communication path is required, the ideal frequency can be selected 
automatically. 

Another type of sound card software is designed for signal analysis. 
Spectrogram by Richard Horne is one example of such software and is 
shown in Fig 1.3. Spectrogram shows the frequency spectrum of an audio 
input, over a user selectable bandwidth, time scale and with selectable 


Fig 1.3. Spectrogram 
screen, showing a 
waterfall plot of a 
WSJT waveform 
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frequency resolution. Some examples of its uses include detecting narrow- 
bandwidth signals buried in noise, setting up audio oscillators and test 
equipment, measuring signal-to-noise ratio and reading very slow CW 
transmissions (illustrated). 


References 

[1] Baycom: www.baycom.org. 

[2] Power Basic: www.powerbasic.com. 

[3] Digital Modes for all Occasions, Murray Greenman, ZL1BPU, RSGB. 


[4] Linux information: www.linux.com. 
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Interfacing to the personal 
computer 


collect data, control a transceiver or turn equipment on or off. As sup- 

plied, most home computers have very few ports with which to inter- 
face to external peripherals. The most common interface is for a printer, 
usually on a so-called printer or parallel port, and one or two serial ports are 
usually provided as a standard means to interface to a wide range of readily 
available peripherals such as modems, plotters, and some types of printer. 
Both of these ports have been available from the beginnings of the PC, and 
they are derived, particularly the serial port, from standards set even ear- 
lier, back in the dark ages of mainframe computers. Neither is terribly fast 
by modern standards. 

More recently the Universal Serial Bus (USB) is taking over the roles of PC 
interfacing, and a whole range of peripheral devices now come with a USB 
interface. This is faster and so can be used for many more tasks — such as 
external disk drives or video interfaces, as well as more traditional ones 
such as printers. USB devices can be cascaded and hubs added, so theoreti- 
cally a PC can have up to 255 external devices added. 

For our purposes, probably the most straightforward interface to use for 
simple digital input and output from a PC is the parallel, or printer, port. It 
appears as a 25-pin female D-type connector on the rear panel. The hard- 
ware associated with this port is reasonably simple in concept, making it 
easy to drive in software. Having said that, operating systems from Win- 
dows 95 onwards can be fraught with problems in trying to gain simple 
access to the printer port, but for now we will assume an older-type ma- 
chine running DOS. 


i] nterfacing a PC to the outside world is often needed, for example, to 


Interfacing using the parallel port 


The printer port consists of three registers mapped into the computer’s in- 
put/output area. On a 80x86-based processor as used in PCs, this is like 
accessing the memory area but with specific I/O commands — other proc- 
essors such as the 6800 family actually do map I/O as memory. In all PCs 
the printer port is allocated to one of two or three specific address locations 
in the I/O space; most often the primary port is allocated hexadecimal 
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Table 2.1 . Detailed description of LPT pin connections and polarity 


—Strobe CO Pulses low 0.5us 


1 
| 2 Data 0 DO Least significant data bit 
3 Data 1 D1 
4 Data 2 D2 
[5 Data 3 D3 
| 6 Data 4 D4 
ye Data 5 D5 
8 Data 6 D6 
9 Data 7 D7 Most significant data bit 
| 10 —Ack S6+ Low pulse 5us after accept 
Bald +Busy Sim 
Bae +Paper End S5+ High for out of paper 
113 +Selectin S4+ High for printer selected 
114 —AutoFd C1- Set Low to autofeed 1 line 
h15 ETON 5, S3+ Low for error/offline/paper end 
| 16 —Init C2+ Set low pulse >50us to init 
PAZ —Select C= Set low to select printer 
| 18-25 Ground 


address 0x378. Alternative locations are 0x278 and 0x3BC. The port takes 
up three successive locations starting at this base address, each location 
having an eight-bit latch associated with it so the PC can either write to or 
read from the port. The outputs or inputs to the latches, after suitable buff- 
ering, form the connections to the 25-pin connector of the parallel port and 
operate at standard TTL logic levels of nominally 0/5V. 

The base location, which we will assume is the most commion one of 
0x378, is mapped to the eight data output lines — in normal operation this is 
used to send a character to the printer. On the modern bi-directional or 
enhanced interface, reading this location can also read the state of the same 
eight lines. The next location, 0x379, is used to read the status of some of 
the control lines and can only be used for inputting data. The third loca- 
tion, 0x37A, operates the strobe pulse and a few more control lines. See 
Table 2.1 for a full description of printer port interfacing. By making use of 
the commonly available printer port, eight data lines are immediately avail- 
able for outputting TTL level signals, or optionally for reading eight bits of 


‘data. Four more lines can be used as outputs, provided pull-up resistors are 


used and note is made of which ones are inverted. Five input lines are 
directly accessible. 
For simple control purposes this port appears ideal for interfacing to 


peripherals, and indeed a number of manufacturers make use of the parallel 


port for connecting custom hardware. Some examples are external CD 
writers, chip programmers and so called ‘dongles’ — used for security and 
copy protection of commercial software. The problems come with modern 
operating systems from Windows 95 onwards. Protected-mode operation, 
inherent to the 32-bit operation of these processors and operating systems, 
prevents direct access to the computer’s hardware to protect multiple 
programmes running simultaneously from being corrupted. So, even when 
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Table 2.2. Programme to flash a LED connected to pin 2 of the printer port 


| def seg = &h40 ‘point at BIOS information table 
AddrLpt% = peeki (8) "Table entry for address of first printer port | 
| print "Flash a LED connected to LS Bit of the Parallel port” | 
print "Parallel Port at address Ox";hex$(AddrLpt%) 'Show it in hex format 


' do 
DEANE SOnee. s 
out Addript% , 0 
delay .5 ‘software delay 0.5s. 
print; Ott": | 
out Addript% , 1 
delay .5 
loop until instat ‘Continue until any key is pressed 
| out AddrLpt% , 0 ‘Leave the port in a known state 


operating in a command prompt window using DOS emulation, accesses to 
the printer port may fail since the Windows operating systems intercepts and 
blocks such calls. Windows does provide its own routines for accessing this 
port, but calling these requires programming in the more regimented 
Windows environment, and losing the ease of programming otherwise 
possible. 

For a computer running a proper DOS operating system, the programme 
in Table 2.2, written in Power Basic, shows how to flash a LED connected 
(via a resistor) to pin 2 and ground. This listing also shows how to look up 
the actual address of the printer port, rather than assuming it follows the 
standard given above. 


The serial port 


Most PCs come with one, or especially on older models two, serial or COM 
ports. Interfacing to these in software can be a lot easier than for the parallel 
port, but the serial format makes it slightly more difficult to make use of the 
data from this port. On most PCs the port takes the form of a nine-pin male 
D-type connector on the back panel, although on very early machines a 25- 
pin male connector was used. Four inputs and three outputs are present so, 
including ground, all pins are fully utilised on the nine-pin connector. For 
the transmission of data, only two of these are really of major importance; 
though others are used for handshaking and control, and can usually be 
hardwired or ignored by software if not needed for their designated pur- 
poses. The two are Transmit Data (abbreviated to “TXD’) and Receive Data 
(RXD). Data is transmitted one byte at a time (usually eight bits) serially by 
toggling the TXD line. The speed of data transmission is determined by 
how much time is allocated to each bit, and a wide range of standard rates 
is possible — usually called the baud rates. Values frequently range from 75, 
150, 300 baud to 115200 baud, doubling each time with a few extra values 
thrown in. The exact signalling protocol used is ideally as defined in the 
RS232 or, as it is now called, the EJA RS232 standard. This is a complex 
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Fig 2.1. Serial bit for- 
mat 
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Baud period 


5,6, 7 or 8 data bits 


plus optional parity bit stop bits 
logic ‘1 


Logic. 1° = —3 to -12V 
Logic '0' = +3 to +12V 


protocol document defined even before the days of PCs, and describes ex- 
actly how the data flow between the peripheral devices is controlled by the 
handshake lines, and the format of the data. The full protocol and most of 
the handshaking functions can usually be ignored, resulting in a much sim- 
plified connection, but whatever route is chosen the data always has the 
following form. 

Each byte is preceded by a start bit, a logic ‘0’, taking up one baud sym- 
bol duration. This is followed by either five, six, seven or eight data bits, 
sent least-significant bit first. A parity bit is sometimes added for error check- 
ing and the block of data is terminated with either one or two logic ‘1’ stop 
bits as illustrated in Fig 2.1. 

The huge variety of data formats alone makes the serial RS232 protocol 
a difficult ‘universal standard’. For computer use, however, one or two vari- 
ants have become more widely adopted. As we nearly always work with 
eight-bit bytes, one byte per frame is an obvious choice, andemore often 
than not we are usually concerned with highly reliable communication be- 
tween two items of hardware over wires, so parity checking is not needed. 
For maximum speed one stop bit is usually considered adequate. The baud 
rates are less standardised, but as older PCs could only cope with speeds 
equal to or less than 19200 baud, this rate is often used. The format is usu- 
ally abbreviated to a form such as ‘19200 N81’ which means 19200 baud, 
no parity, eight bits per character, one stop bit. Lower rates are often used 
when a radio or modem path is included in the link and speed is limited by 
the bandwidth of the link; conversely rates can go up to 115200 baud when 
trying to get the maximum amount of data possible into a PC. The maxi- 
mum amount of data that can be transported for a given speed can be cal- 
culated as follows: 


Characters/second = Baud rate / (1 start bit + Number of data bits + 
Parity + Number of stop bits) 


So for the example given above, characters can be transmitted at the abso- 
lute maximum speed of: 


19200/(1 + 8 + 2) = approximately 1745 bytes/second 


One advantage of this asynchronous serial format is that as characters con- 
tain their own framing information, preceded by a start bit and terminated 
by at least one stop bit, they do not have to be sent continuously — the 
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Table 2.3. RS232 pin connections and signals 


2 3 Transmit Data (TXD) PTE =/DCE 
3 2 Receive Data (RXD) DTE < DCE 
4 7 Request To Send (RTS) DTE > DCE ) 
5 8 Clear To Send (CTS) DTE < DCE ) 
6 6 Data Set Ready (DSR) DTE < DCE | 
7 5 Ground (GND) 
20 4 Data Terminal Ready (DTR) DTE > DCE 


moo Uiecioneceeuopecahiet steleAhdnd ttn tn hse merase tnnomnenycmesabareananannannshnata austen ese trans nesmenntnenwinnehhennt ssn aneeanccnernan ener reed 


hardware continuously searches for a start bit and only reads the character 
when the transition from logic ‘1’ to ‘0’ is detected. It is also possible for 
receiving software to determine the baud rate automatically. By storing the 
entire contents of the received signal waveform, software can search for 
transitions and measure the minimum distance between them. As the posi- 
tion and polarities of the start and stop bits are known, after a few charac- 
ters have been received the correct baud rate can be deduced from timing 
measurements. This procedure is speeded up if a sequence of known char- 
acters is always present. An example of auto baud determination is seen 
when an external telephone modem is connected to a PC. Modems are 
controlled by commands sent over the RS232 interface that always begin 
with the letters ‘AT’. The first time a modem encounters any signal transi- 
tions on the RS232 interface it knows the first two characters must be ‘AT’ 
and, by examining the pattern of ‘1’s and ‘0’s, can determine the speed of 
the interface. 


RS232 connections 


RS232 was originally defined as a standard to interconnect a modem — the 
Data Communications Equipment (DCE) — to a Data Terminal Equipment 
(DTE), and pin allocation and labelling was made accordingly. The DCE 
has a female connector, either 25-pin or nine-pin, and the DTE has a male 
connector; leads for connecting a DCE to a DTE are connected in parallel, 
pin 1 to pin | etc, assuming the same connector type. Terminology for the 
Received Data (RXD) and Transmit Data (TXD) signals are as if they are 
used over a modem interface, ie a DTE puts out Transmit Data, and re- 
ceives RXD. At a DCE port, this terminology can be confusing as TXD 
now reads in the data (from the DTE) and RXD sends it out! We need to be 
very aware of this potential for confusion, as peripherals designed to inter- 
face to a PC via the serial port are often configured as a DCE to enable a 
one-for-one connection. 

The meanings of the signals and associated pin connections are given in 
Table 2.3. Certain other connections are also available on some 25-pin in- 
terfaces that are not used with the later nine-pin version. 

By adhering to the DTE/DCE convention, connections, connector po- 
larity, signal names and data flow is logical and (almost) intuitive. Things 
get rather more complicated when two DTE-type equipments need to talk 
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Fig 2.2. Pin connec- 
tions for an RS232 
null-modem cable’ 


28 


Pin no Function Function Pin no 
25-pin 9-pin 9-pin 25-pin 


3 3 


to each other. An example of this is when trying to connect two computers 
via their serial ports — for example, to swap files between machines with 
completely different operating systems. Here a connection type known asa 
null modem is needed — so called because it behaves as if replaces a pair of 
modems. A null modem cable has a female connector at each end and, as a 
minimum, has the TXD and RXD connections swapped over plus ground. 
Usually RTS and CTS are crossed over, and frequently DTR and DSR. 
This way, each DTE can now provide the handshaking signals required for 
a full intercommunication protocol. More often, however, the full hand- 
shake is not provided, and CTS is often just connected to RTS, and DTR to 
DSR locally at each end, so each computer in effect provides its own hand- 
shake. See Fig 2.2. 

Further complications are sometimes added when manufacturers of some 
equipment provide RS232 interfaces with the wrong polarity of connector. 
In one case of recent experience, considerable time was wasted finding 
cable connections to interface to a professional HF receiver that purported 
to have a 25-way RS232 connection on the back. This was configured as a 
DCE (sensible) buthad a male connector, required RTS/CTS handshaking, 
and did not provide a suitable signal to activate the controlling PCs DSR 
input. The moral is, to paraphrase from reference [1], “Once you have found 
an RS232 lead that works for your particular application, guard it with your 
lites 


Voltage levels for RS232 interface 


~ RS232 was originally defined as follows: logic ‘1’ equals -3 to -12V, logic 


‘0? equals +3 to +12V. The region from -3 to. +3V was undefined and 
constituted an error. Therefore the ‘resting’ state of an RS232 interface, 
when active but not sending data, has a negative voltage on the data line, 
corresponding to the state of the last stop bit (a logic ’1’), and usually a 
positive voltage on the DTR line for a logic ‘0’, indicating the serial port is 
active. 

The presence of both positive and negative voltages on various pins when 
the port is in use can lead to some interesting short cuts when using it for 
interfacing. Although the threshold for detecting the presence of a ‘0’ or ‘1’ 
would ideally be at zero volts for optimum discrimination of the two volt- 
age levels as defined above in the presence of noise, it is usually set at 
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around +1.5V in most RS232 receiver chips. The reasons are twofold. First 
(and probably historically), it allows an open-circuit line to be treated as if it 
were negative, ie at logic ‘0’, which in the case of the TXD/RXD lines is an 
error condition, and in the case of any of the handshaking lines represents 
an inactive state — so an open-circuit condition cannot give a false indica- 
tion. The second reason is that in the early days of home computers — the 
BBC Computer era — manufacturers economised on the serial interface by 
using just the logic levels of 0/5V rather than having to introduce a nega- 
tive supply and higher voltages. Having the ‘true’ RS232 receiver chips 
switch at +1.5V meant that this much simpler interface, which could be as 
simple as a single TTL or CMOS buffer as the line driver, would interface 
with peripheral devices that employed the ‘true’ signalling voltage levels. 


Driving the serial port 


Unlike the parallel port, it is usually not necessary to directly access the PC 
hardware in order to gain control of the COM port(s). All programming 
languages have commands or routines within them to open these ports, set 
the operating parameters and allow data to be written to or read from them. 
This allows the serial interface to be used with any operating system from 
DOS, any variant of Windows or any OS of choice. Table 2.4 is a listing in 
Power Basic showing how the COM port can be used to receive serial data 
and print it to the screen. Table 2.5 illustrates how data may be sent over 
this interface. Some programming languages even include hardware 
handshaking as part of the serial port setting-up commands. If direct access 
to the hardware is possible, the serial port can be used in a number of non- 
standard ways, for example using the RTS line as a CW keyer output to 
drive a transmitter. 

If it appears that undue attention is being paid to a slow old-fashioned 
interface, remember that RS232 is the only ‘standard’ that has truly en- 
dured across every computer since the dark ages, and is probably the only 
standard that can be guaranteed to be compatible across computer plat- 
forms for a long time to come. Its serial nature allows a natural connection 
for radio-based applications, and it is simple to design interface hardware, 
as numerous projects later in this book will show. 


The ISA bus 


Until the very latest machines came along, all PC motherboards had at 
least one spare PCB socket that gave direct access to the PC’s data, address 
and control lines. This means that it is possible, with suitable address de- 
coding and interfacing circuitry, to add hardware to a PC that allows data 
to be directly read from, or sent to the processor, giving the fastest possible 
transfer mechanism. The ISA (Industry Standard Architecture) bus is rec- 
ognised by its double-sided 31-way PCB-type connector next to a smaller 
18-way connector as shown in Fig 2.3. 

The larger one can be used alone, and gives access to just the lowest eight 
data bits with address lines AO to A19 and all the control signals needed - it 


29 


COMMAND - Computers, Microcontrollers and DSP for the Radio Amateur 


Table 2.4. Programme to receive data over the serial link and print to the screen, with identifi- 


cation of the I/O port address 


print "Example programme to receive data over the serial link" 
"Prints data directly to screen 


‘First of all, find hardware location of COM1 


| def seg = &h40 "Data table in BIOS memory 
Addrcom% = peeki (0) ‘Entry in table for COM1 port I/O address 
print hex$(Addrcom%) "Just show the address as we don’t actually need it here 


open "COM1:9600,N,8,1,DS,CS" as 1 
"Open COM 1 serial port as file reference 1 
"9600 baud, No parity, 8 data bits, 1 Stop bit, 
"Ignore DSR and CTS handshaking lines (for simple interfacing) 


on com(1) gosub GetSer "Generate interrupt each time a character is received 


com(1) on "Turn on the interrupt 3 
do "Somewhere to idle away the hours while 
_ loop until instat " waiting for an interrupt. 
" Just loop until any key is pressed 

end 
GetSer: "Serial port interrupt handler 

1% = loc(1) "Look to see how many characters have arrived 

c$ = input$(1% , 1) "Get all new characters and read into string c$ 

print c$; "Print all received data to screen a 
return 


Table 2.5. Programme to send data over the serial link 


print "Example programme to send data over a serial link" 
"Echos any character typed on the keyboard to COM 1 


open "COM1:9600,N,8,1,DS,CS" as 1 
"Open COM 1 serial -port as file reference 1 
"9600 baud, No parity, 8 data bits, 1 Stop bit, 
"Ignore DSR and CTS handshaking lines (for simple interfacing) 


do 

while not instat : wend "wait for any keyboard key to be pressed 

c$ = inkey$ "Get the character just entered 

PUTAS Coaac "Send it to the serial port 
loop until ¢$ = chr$27) "Keep doing this until [esc] key is pressed 
end 


derives from the very first PCs that had just an eight-bit data bus and 1 
megabyte of memory space. The smaller connector gives access to the upper 
byte of the data bus, allowing full 16-bit access as well as a few more control 
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signals; 32-bit access is not possible using the 


ISA bus. Table 2.6 gives a description of the aie sa — hae 
signals present on this bus. .. GNM Waster 

Connecting via the ISA bus makes it feasi- 3 > GMB 5v0c 
ble to build hardware that uses spare I/O space 12 > GH br” 
for independent input and output, or alterna- 10 GG cK” 
tively to use spare memory space for faster RED GHB nos 
memory-mapped I/O or direct memory access a4 Gl OAC: 
(DMA). These latter techniques are too com- = Re Ga ro 

vw GR 4cK5 

plex to cover here but interfacing details can a GHEEMB 0200 
be found in reference [2]. oo ap GEE 0AcKo 

Fig 2.4 shows the circuit diagram of a sim- a’ > GHEE 1a. 
ple eight-bit latched input/output stage which au? D> 


is mapped to a spare I/O space at address 20 
0x300 - the I/O space from 0x300 to 0x31F is a2] 
allocated for user hardware. its —~ 

Data is written to this user interface simply oe 


by writing a byte to I/O address 0x300 where 


it is latched into the output flip-flop. Data may A3t 
be read from the input lines by reading from 0 
this I/O address. 1 > 
Later PCs have a smaller edge connector, 2D 
giving access to the full 32-bit bus (this is the 3 aD 
modern PCI interface) but using this interface < 
is not nearly so straightforward as the ISA bus. ca —_ 
The PCI interface has been defined to make 7 
use of the plug-and-play capability of operat- a 
ing systems to automatically recognise new 0: 
hardware. 0» 
Connecting to the PCI bus is beyond the 1 
scope of this book and requires custom chips, 2 

: . : A13 
but full details are available in reference [3]. ae — 
6 > 
Timing issues ~> RAEN 
7 
One area that the basic PC is not good at is a 
running real-time software! While reasonably oo 
accurate date and time keeping is available eS ( 
using the internal real-time clock, generating | /o7Ry a» 
intervals of micro or milliseconds is near-im- > EES 
possible with any accuracy. ‘Raw’ DOS in- - TREES 
cludes a software timer that generates an inter- in — 
rupt every 55ms approximately and is part of . 
the operating system, and timing can gener- — 
ally be defined to an accuracy of this order. In os SRR 
fact, several programming languages include 7 
jo ch* > GE ow: 


Right: Fig 2.3. ISA bus pin-out 
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Table 2.6. ISA bus (Industry Standard Architecture) signal descriptions 


| SAO toSA19 — System Address bits 0 to 19 are used to address memory and 1/0 
devices. Only the lower 16 bits are used during I/O operations to 
address up to 64k I/O locations. SAO is the least significant bit. 

SA19 is the most significant bit. These signals are gated on the 
system bus when BALE is high and are latched on the falling edge 
of BALE. They remain valid throughout a read or write command. 
These signals are normally driven by the system microprocessor or 
DMA controller but may also be driven by a bus master on an ISA 
board that takes ownership of the bus. 


| ALE Address Latch Enable (also sometimes called BALE = Bus Address 
Latch Enable). The address bus is latched on the rising edge of this 
signal. The address on the bus is valid from the falling edge of ALE 
to the end of the bus cycle. 


AEN Address Enable is used to degate the system microprocessor and 
other devices from the bus during DMA transfers. When this signal 
is active the system DMA controller has control of the address, 
data, and read/write signals. This signal should be included as part 
of ISA board select decodes to prevent incorrect board selects 
during DMA cycles. 

SDO0 toSD15 = System Data serves as the data bus bits for devices on the ISA bus. 

: SD15 is the most significant bit. SDO is the least significant bits. SDO 
to SD7 are used for transfer of data with eight-bit devices (eg this 
lab). SDO to SD15 are used for transfer of data with 16-bit devices. 


! 


| 
| 
| 


-IOR I/O Read is driven by the owner of the bus and instructs the 
selected I/O device to drive read data onto the data bus. 
| -IOW I/O Write is driven by the owner of the bus and instructs the 


selected I/O device to capture the write data on the data bus. ) 


functions that generate interrupts at multiples of this interval such as the 
ON TIMER command in all dialects of Basic. Measurement of events such 
as I/O lines changing is sometimes possible to microsecond accuracy using 
a microtimer, but this in turn falls off in accuracy as time intervals approach 
55ms. 

The Windows operating system, including the command prompt win- 
dow, is much worse still. As Windows is a multitasking operating system, it 
is continuously servicing all the independent pieces of software running, 
and so no guarantee can be provided that machine resources will be avail- 
able to the wanted software at the required intervals. By operating a com- 
mand prompt window at full screen, most of the PCs resources can be di- 
rected to the software and a reasonable approximation to real-time opera- 
tion is usually possible — subject to the 55ms timing issues. 

The 55ms timing interval derives from dividing an hour by 65536. Quite 
why the timing interval should be derived like this is by now lost in the 
folklore of computer history, but for accurate timing purposes the exact 
interval is given by t= 3600/65536 seconds, or 54.93164ms. This of course 
is subject to the accuracy of the oscillator used for the PC’s timing clock - 
this is often just a packaged crystal oscillator and easily subject to an error 
of 50 parts-per-million or worse. 
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PC ISA bus 
eee 
D7! O 
i Hatpheko 
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[ead 1 
ee ann s 
yi! ' 
\ ; O LT ES TTS TTS Eee Tn oc pal fel le fal as 
Orne fe fae fee | ef me J mm 
' 
ae ly 
A ee acl ee Ce ceed wee Ie epee et u 
' : 0x300 
' : Write 
' 
' ! 2 
' } 18 
' 16 
ie 4: 74HCT32 7 
' 
peas) a th 12 
—_—_— 
FB : 5) > 9 
we 7 
\ ' 5 
ne 
Sie: 
rail 74HCT138 0x301 T4HCT244 
' ' Read 
AQ! Om pe 
Al! Om on 
1 
A2! Om DS 0x302 Enable etc 
' 1 O 
nae aul ae 
A ,10__ Individual address enable 
reve ae Hg lines for 0x300 to 0x307 
en 02 
A ' 
“ae 
' 
a | 
at F 
' 
A5! O = 
A6*O=— 0 Decoded addresses 
Agios 53 0x300 to Ox3FF 
' 52 
' 11 
uae ° 
Ren ox 510 
AEN! Ome o 
A7' © ' 0 
ee 


7T4HCT374 


Latched 
outputs at 
1/0 address 
0x300 


Input Data 
read at I/O 
address 

0x301 


CW keyer programme 


The Power Basic listing given in Table 2.7 is for a CW keyer for a beacon 
transmitter that sends a user-entered message at predetermined intervals. 
The message, CW speed and repeat interval can be changed arbitrarily while 
the programme is running. 

The transmitter is keyed via the DTR line of the RS232 interface and the 
RTS line is used for transmit/receive control if this facility is wanted. As 
keying speeds (CW dot lengths) that are exact multiples of 55ms do not 
give a useful range of CW speeds, the programme shows one way of gener- 
ating reasonably accurate time delays that are not restricted to multiples of 
this interval. A software delay is generated in a loop and at the start of the 
programme this delay loop is calibrated by making use of the microtimer 
instruction. The calibration constant so determined is then used to generate 
an accurate Ims time delay. This technique is quite good when used on 


Fig 2.4. Circuit dia- 
gram of a eight-bit 
I/O latch on ISA bus 
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Table 2.7. CW Beacon, or test keyer, programme. Sends CW equivalent of a message typed in, 


at user specified speed and repeat interval 


cls 
dim charray$(127) 
calibrate = 1 


interval =1 ‘needed initially to calibrate delay loop 

mtimer "Initialise the microtimer 

cal] pause(500) 

tim = mtimer ‘mtimer command measures no. of us for 500 loops 
calibrate = 500000 / tim "number of original loops for 1 ms. 


‘calibrate constant now defined 


' 'Now define Cw characters 
data 01,1000,1010,100,0,0010,110,0000,00,0111,101,0100,11,10,111,"0110" 
data 1101,010,000,1,001,0001,011,1001,1011, 1100 Aw TZ 
data "11111","01111", "00111", "00011", "00001" , "00000", "10000", "11000", "11100","11110"'0 - 9 
! Special case for punctuation, stored with character 


data " e " ; "910101" : ieee : "70010" : Wr - "0901100" . " : " : "aT OOn 1 : woe : "10001" ; wow ; "100001" 
for a% = 65 to 90 "ASCII A-Z 
| next a% 
for a% = 48 to 57 "ASCII 0-9 
read charray$(a%) 
/ next a% 
fore z= 1 to6 "allowed punctuation symbols 
read sy$,charray$(asc(sy$)) 
next Z 


if dir$ C"KEYER.INF") > "" then '.INF file saves COM port in use 


open fis) 1 3 KEYER NE 

input #1 , cport% 

close 1 
else 

input "COM Port for interface ",cport% 
end if 


read charray$(a%) 
charray$(a% + 32) = charray$(a%) "lower case 
+ 
| 


if cport% = 0 then cport% = 1 

if cport% > 4 then cport% = 4 ‘COM Port > 4 not allowed 

def seg = &h40 "CORRECT way to find location in I/O space, address table in segment &h40 
mcraddr% = peeki(cport% * 2 - 2) "Location of UART base I/O address 

if mcraddr% = 0 then print "No COM";cport%;"port at this address" : end 


mcraddr% = mcraddr% + 4 ‘now point at modem control register 
out mcraddr% , 0 
print "Transmit test keyer - stays in Key Down state during pause" 


keyerbit% = 1 "RTS Keys transmitter for compatibility with VE2IQ 'COHERENT’ 
txbit% = 0 "DTR Controls Tx/Rx switching 
locate 3,1 
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Table 2.7 (continued) 


Keyer uses serial port COM";cport%;"for interface 
p 


‘Output from RTS and DTR lines, Polarity: +ve = key down / Tx active 
*25 Way connectors - pins 4 and 20 Gnd pin 7 
"9 way connectors - pins 7 and 4 Gnd pin 5 


locate 4 , 10 

input; "Speed wpm ", speed 

if speed = 0 then speed = 18 : print "18" 
| oldspeed = speed 


locate 5 , 10 
Input; "Repeat delay ",repeatime 
| oldrepeat = repeat 


locate 9 vent 8) 
| print tab(10);"Allowed punctuation af 
| color 15. 
| for a% = 33 to 127 
if (a% < 48 or (a% > 57 and a% < 65) or (a% > 90 and a% < 97) or a% > 122) and 
| charray$(a%) > "" then 
i print :chr$(ax) 4007s 
end if 
| next a% 
i color 7 


' locate 11 , 10 
| line input "Text ",tx$ 
tx$ = ucase$(tx$) 


at tx$ =." then tx$ =" "TESTING TESTING 123" 
locate 11 , 16 
print tx$ 


‘User prompt to show keyboard characters that allow change of speed, 
"repeat interval and text while programme is running 


locate=25..,/15 


COVORUL2 22: 
PINE: [esc]"; 
COLOR ase print: rs 
Peolom a2: printsss \3 
color 7:print "peed hae 
Colored 2eprantue Res 
color 7:print "“epeat interval ie 
| ‘color 12:print."T"; 
color.7 sprint “ext a 


peolor’ 77; 6 


do 
interval = 1200 / speed "dot clock interval ms 
locate 15 , 30 
color 10 


bit set mcrdat% , txbit% 


| 

| 

1 

; 

i incr rno& 
i 

i 

| 

i out mcraddr% , mcrdat% 
i 


Fannie iste nanan sevenecsosssnonsnanisieitessenoaresnrnehoesnesnnesnasnnupsreinssihoh si inn. sess hnneicn sis ensnnnnnssene nbn sna 
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Table 2.7 (continued) 
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print "Sending"; 
locate 16 , 1 
for t% = 1 to lTen(tx$) 
curchar% = asc(mid$(tx$ , t% , 1)) 
if curchar% = 13 or curchar% = 32 or curchar% = 8 then 
call pause(2) 


PREAt gies: 
else 
pattern$ = charray$(Ccurchar%) 
if pattern$ = "" then iterate for 
for symbcount% = 1 to len(pattern$) 
dotdash$ = mid$(pattern$ , symbcount% , 1) 
bit set mcrdat% , keyerbit% 
out mcraddr% , mcrdat% 
if dotdash$ = "0" then 
print? 
call pause(1) 'send dot 
else 
prantss-22 
call pause(3) "send dash 
end if 
bit reset merdat% , keyerbit% 
out mcraddr% , mcrdat% 
call pause(1) "Intersymbol gap 
next symbcount% 
call pause(2) "letter gap 
PENN tae cae 
end if 
next t% 


if instat then ik$ = ucase$(inkey$) ‘Check for keyboard hit & read char. 
locate 16 , 1 

print space$(80) ; 

lecatesi7sgul 

print space$(80); 


TF 1k$ > “" then "Take action on any user intervention 
Tocate -15-..30 
print space$(20) 
select case ik$ 
case "R" "Request a new repeat interval 
color 7 
jocate Ss 2 220 
print space$(60) 
locate 5 , 10 
Input; "Repeat interval (s) ",repeatime 
if repeatime = 0 then 
repeatime = oldrepeat 
locate csrlin , pos - 1. 
print repeatime 
else 
print 
end if 
oldrepeat = repeatime 
ee 4 oo 
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case "S" 

color 7 
locate 4 , 10 
print space$(60) 
locate 4 , 10 
Input; “Speed wpm 
if speed = 0 then 

speed = oldspeed 


locate csrlin , pos - 1 


print speed 


else 
print 
end if 
oldspeed = speed 
ae ae 
case "T" 
color 7 


locate 11 , 10 

print space$(60) 

Jocate 11> ;;10 

line input "Text ",tx$ 
tx$ = ucase$(tx$) 


tr OeX$ = vtheny, end 
locate 11 , 16 

print tx$ 

Gea oo 


end select 


"Request a new speed 


", speed 


"Request new text to send 


else ‘Otherwise sit in loop looking for next repeat interval 


locate 15 , 30 
color 12 
print "waiting" 
bit reset mcrdat% , txbit% 
bit reset mcrdat% , keyerbit% 
out mcraddr% , mcrdat% 
call pause(3) 
out mcraddr% , mcrdat% 
delay repeatime 
bit set mcrdat*% , txbit% 
out mcraddr% , mcrdat% 
call pause(3) 
end if 
if instat then ik$ = ucase$(Cinkey$) 
loop until ik$ = chr$(27) 
out mcradr% , 0. 
end 


sub pause(ms%) 
shared calibrate , interval 
for a& = 0 to calibrate * ms% * interval 
‘delay once calibrated 
next a& 
end sub 


"Escape key to get out 


"Global variables 
"This loop generates ms% * 1ms 


Table 2.7 (continued) 
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Table 2.8. Connections for the game port, 15-way D-type female connec- 
tor 


Se Potentiometer common Joystick A (+5V) 
ae Button 1, Joystick A 

3 X Co-ordinate potentiometer for Joystick A 
4 Button common Joystick A 
nS ‘Button common Joystick B 

6 Y Co-ordinate potentiometer for Joystick A 
| 7 Button 2, Joystick A 
{8 Unused 
19 Potentiometer common Joystick B (+5V) 
| 10 Button 1, Joystick B 
111 X co-ordinate potentiometer for Joystick B 
Que: Used for MIDI interface only, Transmit 
Pols Y co-ordinate potentiometer for Joystick B 
| 14 Button 2, Joystick A 


ie) Used for MIDI interface only, receive 


older, slower machines running true DOS, and can give quite acceptable 
results in a full-screen command prompt window. 


Other ports 
There are a few other ports on a PC that are accessible for user input/ 
output. 
¥ 
Game port 


One of the oldest is the game port, or joystick port — this is usually accessi- 
ble via a 15-way D-type connector and, as its name implies, is intended for 
the connection of two joysticks. 

Each joystick contains two potentiometers, making a total of four that 
can be connected, plus two press-button switches. Each potentiometer con- 
trols the delay on one of four monostables, and the delay can be read by 
software, as can the status of the press buttons. The game port is probably 
of little value for any other functions than what it was designed for, but the 

_ press-button lines could be used for single-bit status monitoring of some 
experimental equipment without having to tie up either the COM or paral- 
lel ports. 

One possibility would be for monitoring the squelch status of an FM 
receiver while scanning a band for activity — see the next chapter. Connec- 

- tions for the game port are shown in Table 2.8. The buttons can be read 
directly by reading port 0x201 and looking at bits 4-7; no triggering is 
required. 


Universal Serial Bus 


The USB interface is one of the latest connections to appear on modern 
PCs. It is only accessible through Windows, and requires users to make use 
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of libraries and operating system calls for the PC driver software. However, 
USB is extremely versatile and capable of speeds of several megabits per 
second. At the peripheral end, a range of dedicated USB chips now exist 
that make interfacing to this port straightforward. Also, USB driver ‘cores’ 
are available within some microcontroller chips, the intention being to make 
operation using USB as transparent to hardware designers as possible. Full 
details of the USB specification are available from reference [4]. Suitable 
interfaces are given in references [5] and [6]. USB peripherals can be pur- 
chased that add extra parallel or serial ports — although when installed, 
these are only usually available for Windows software and cannot be used 
through a command prompt window. By using the USB interface for the 
system printer, the LPT port can be freed up for interfacing as described 
earlier. 


The sound card 

Apart from its obvious use for input and output of audio signals, the sound 
card can be treated as an analogue I/O port. Its frequency response does 
not extend down to DC, rolling off at a few tens of hertz usually — so it is 
really only suitable for audio-like signals. However, at its fastest sampling 
rate of 44kHz it can cope with signals up to 20kHz, making it suitable for 
looking at portions of the RF spectrum that could contain many signals. 
Refer to Chapter 10 for use of the sound card. 


Isolation and EMC issues 


Electrically, all computers can be considered as ‘dirty’ items of equipment. 
All generate spurious signals that are multiples of their many internal oscil- 
lators, rapidly switched data and address lines, and harmonics from switched- 
mode power supplies. Here, modern machines are a lot better than their 
older counterparts as the modern EMC legislation they now have to meet is 
quite strict. 

However, much can be done by users to minimise coupled interference. 
In most cases the PC itself is quite well screened, although some branded 
makes are very much better than others here. Most interference problems 
come from the very interconnections we need to make our interfaces. RF 
signals generated within the case are coupled onto the I/O ports and so to 
the outside world. 

The use of screened cable for connections to the serial and parallel ports 
can do a lot to minimise radiation of these coupled signals. The screen must 
be firmly bonded to the chassis at each end to be effective but, when these 
cables connect to sensitive radio receivers, for example, it can still be diffi- 
cult to keep the spurious signals down to manageable levels. Bypass capaci- 
tors and ferrite beads strategically placed can do a lot to help, provided 
they do not degrade the interface signal waveform. 

Depending on the application, there are a few interface circuits that can 
be employed to drastically cut down coupled signals. Optical coupling is a 
very useful trick to both remove ground loops and common-mode RF 
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signals. Fig 2.5 shows a sim- 
ple opto-coupled interface 
for the RS232 data lines. A 
separate battery is needed 
to supply power for the PC 
side of the interface but this 
can be switched automati- 
cally from the PC end via 
DTR, making use of an- 
other opto-isolator, as 
shown. Sensitive relays that 
can be directly driven from 
the power available on the 
serial port can also be used. 

Small 1:1 isolating trans- 
formers can prove useful 
for audio interfacing to the 
sound card. These are usu- 
ally designed for 600Q sys- 
tems, but work adequately 


Fig 2.5. Opto-cou- for this task. More details on interfacing the sound card are given in refer- _ 
pee RS232 inter- ance [7]. 
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CHAPTER 


Transceiver control and band 
monitoring 


cility for remote control of all the front-panel functions. By con- 

necting a transceiver to a PC or other type of controller, a whole 
new world can be opened up of automatic band tuning and scanning, auto- 
matic frequency selection, beacon monitoring and spectrum analysis, to 
name but.a few. 


M ost modern amateur radio receivers and transceivers have the fa- 


Transceiver interfaces 


Almost all modern transceivers have an interface for computer control, and 
there is a wide variety of software available to communicate with the 
microprocessor inside the rig that controls the frequency synthesiser and 
many other functions. The 
following section is taken 
from reference [1]. 


The PC software ex- 
changes data with the trans- 7 
ceiver using one of the PC’s OE tadlen) tread / an maf 


serial interface or COM 
ports. The COM port uses ener sv // 
the RS232 interface for ex- 

changing serial data with the 

outside world. The problem is that most transceiver serial ports provide 
TTL-level signals: +5V for logic ‘I’ and OV for logic ‘0’. Fig 3.1 shows why 
an interface is needed in order to shift these voltage levels between the two 
systems. Controlling a transceiver by a PC is usually a two-way data 
exchange, so each direction needs its own level shifter. 

A few transceivers now provide direct plug-and-play RS232 compatibil- 
ity, using a nine-pin D-type connector which is similar to the PC’s COM 
port. All others need an interface, so let’s examine the connector pins at the 
COM port to see what’s needed. The DCE/DTE conventions as defined in 
Chapter 2 do not apply here, and connections are not necessarily via a null 
modem cable either. The ‘Connects to’ column shows how all the lines 
from the PC connect to a different-named line at the other end of the link, 


(both directions) 


RS-232 Transceiver (TTL) 


Level-shifting requirements 


©RsGB RC3407 


Fig 3.1. Level-shift- 
ing requirements 
between RS232 and 
TTL 
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Fig 3.2. Generic In- 
terfaces from 
RS232, (a) three- 
wire Yaesu, (b) five- 
wire Kenwood with 
full RTS-CTS 
handshaking, (c) 
simplified three- 
wire Kenwood with 
handshaking emu- 
lated by CTS-RTS 
linking at each end 
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Transceiver (TTL) 


Level 
shifters 


Oo TXD 
(serial out) 


ORXD ml 
(serial in) aco 
0 GND 
(a) 
TTL 
inverters 

Generic 
Kenwood 


a 
inverters 


Simplitied 


Kenwood 


©RSGB RC3408 


with the single obvious exception of ground. The most important pair is 
TXD and RXD. The TXD output from the PC carries transmitted data 
from the PC to the transceiver, and is connected via the interface to the 
transceiver’s RXD input (sometimes called ‘Serial In’). The transceiver’s 
TXD output (or Serial Out) sends data back to the PC’s RXD port. The ‘Big 
Three’ transceiver manufacturers each have different control protocols and 
different hardware interface requirements, and these also vary between dif- 
ferent transceivers from the same manufacturer. The control protocols are 
usually handled for you by the software authors — and now, here’s how to 
handle the hardware requirements. 

All that’s absolutely needed for two-way serial communication are just 
three wires: TXD, RXD and ground. That’s what Yaesu rigs use (Fig 3.2(a)). 
In this kind of ‘free streaming’ communication, either end can send data 
whenever it wants, and this works fine for the kinds of simple, direct links 
we need for transceiver control. The Kenwood interface is more complex: 
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Transceiver (TTL) 


(serial out) 


ORXD 
(serial in) 


© GND 


©RSGB RC3409 


it uses reversed TTL logic polarities (indicated by the TTL inverters in Fig 
3.2(b)) and it also requires Request To Send (RTS) and Clear To Send (CTS) 
handshaking on two additional lines. This RS232 jargon means that no data 
is supposed to be transmitted until the other end has been asked if it’s ready 
to receive (RTS), and has sent back a confirmation (CTS). Fortunately RS232 
communication doesn’t always insist on such formalities. The hardware 
handshaking needs of Kenwood rigs can usually be satisfied by linking the 
RTS output directly back to the CTS input on the same connector (Fig 
3.2(c)) — in effect, each device tells itself to go ahead. 

Next let’s look at some hardware for level shifting. Remember that the 
aim is to translate the TTL levels from the transceiver into RS232 (or com- 
patible) levels for the PC (Fig 3.1). The first practical interface (Fig 3.3) uses 
a MAX232 IC to generate true RS232 voltage levels. To fall securely inside 
the RS232 specification, this requires DC supply rails at about +10V and 
-10V. The MAX232 revolutionised TTL/RS232 interfacing by generating 
both of these voltages on-chip from a standard +5V TTL supply, which 
makes the whole design very simple. The MAX232 contains two level shifters 
in each direction, so it can provide a more complete RS232 interface with 
handshaking if required. Fig 3.3 shows a MAX232 interface for Yaesu trans- 
ceivers such as the FT-980 and FT-990 that don’t already have a PC-com- 
patible COM port. Wire it up in a small shielded box close to the trans- 
ceiver, apply +12V (which the 78L05 regulates down to +5V) and away 
you go with real RS232 bipolar signalling. More elaborate interfaces for 
Yaesu, Icom and Kenwood rigs using the MAX232 are described in recent 
editions of the ARRL Handbook. 

However, interfaces can often be much simpler than that. We don’t re- 
ally need true bipolar signalling, because the RS232 receiver ICs used in 
PC COM ports don’t insist on the full-specification voltage levels. The noise 
margins are much reduced compared with true bipolar RS232 with its 20V 
swing, but they are generally adequate for short screened runs between a 
PC and a transceiver. Fig 3.4 shows an example for Yaesu rigs. Rl] connects 


Fig 3.3. Practical 
Yaesu interface us- 
ing MAX232. The 
values of C3—C6 are 
dependent on the 
variety of MAX232 
chip used (see the 
data sheets) 
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Fig 3.4. Practical 


Yaesu/Icom inter- RS-232 D2 Transceiver (TTL) 


face deriving power 1N4148 
from the COM port. = 
Note the link for the 
Icom ‘single wire’ 
data bus D3 
1N4148 


GND 
©RSGB RC3410 


Fig 3.5. Icom ‘single 
wire’ (plus ground) 


ClI-V data bus allows Icom 
multiple rig control; i radio 3 


also used by Ten- |e TXD 
Tec © 5 13-1xD eo ESS iat 
x 


the PC’s TXD port to the base of TR1, and a positive RS232 ‘space’ level 
will pull TR1’s collector voltage down to ground. The negative RS232 ‘mark’ 
condition biases TR1 into cut-off (negative base voltage is limited by D1) so 
that R2 can pull the output line up to a valid TTL logic ‘1’ level. TR2 works 
in a similar way: whenever the transceiver puts a TTL logic ‘1’ on the line, 
TR2 pulls the RXD voltage at the PC COM port almost to zero, which the 
PC’s RS232 receiver IC interprets as a valid ‘mark’. 

Icom rigs are different because they use a simple ‘one wire’ interface 

(actually a single wire plus ground screen). The Icom CI-V control protocol 

' is quite sophisticated: it not only handles signalling both ways along the 
single wire, but also allows the PC interface and several Icom rigs to share 
that one data line (Fig 3.5). The CI-V system sends individually addressed 
data packets to each rig, and likewise recognises the identity of each rig 
when receiving data. The Icom hardware interface thus requires the input 

and output to be commoned - in Fig 3.4 simply link TXD and RXD at the 
transceiver side as shown. Examples of some of the Icom control codes for 
the IC746 are given in Table 3.1. 

The two-transistor interface in Fig 3.4 needs no external power supply. 
The positive rail is generated directly from the RS232 port via D2 and D3, 
which are connected to the RTS and DTR lines. Either or both of these 
lines usually sits at the RS232 ‘space’ level of about +10V. C1 stores this 


©RASGB RC3411 
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Table 3.1. Some of the Icom control codes for the IC746 transceiver 


Controller to IC-746 (all codes in hexadecimal): 


fe [re | se] | on [x | bataarea | 


1C746 to controller: | 


Some example commands are shown below. For the complete command table and 
a more complete description, refer to the transceiver handbook. 


Cn Sc Description ) 
00 Sets frequency (in data area) 
Oise KK Sets mode (transceive) 

05 Sets frequency 


06 00 LSB mode 

06 ,.91 USB mode 

faQbe Os CW mode 

) OF; 00 Turns split operation OFF 

| OF 01 Turns split operation ON 

Geer 40 Selects simplex operation 

| 16° 500 Sets preamp OFF 

16 12 Sets AGC ON, Slow 

| 1B. 00 Sets the tone frequency for repeater use 


Numbers in the data area are sent in packed binary coded decimal form, two digits 
_ per byte. For example a frequency of 144.57500MHz would be coded as: 


00 75 45 14 

voltage and takes care of any minor gaps in the supply. Stealing a small 
positive and/or negative supply from the RS232 port is a well-known tech- 
nique, but is limited to a few milliamps only, so it won’t work with the basic 
MAX232 circuit in Fig 3.3. 

An opto-isolated RS232 interface was shown in Fig 2.5. If you have mul- 
tiple transceiver-PC interconnections including audio, these interfaces can 
be very useful because they also break the ground connection, which may 
help prevent hum loops. 


Watchdog timer for computer control of transmitters 


Using a PC to control transmit/receive switching, such as is usual for most 
data mode software, could allow the transmitter to stay in transmit mode 
indefinitely if there was a software crash or malfunction. The only solution 
is then to reboot the computer, remove the interface connector or switch 
off the power to the rig. 

Most data mode software interfaces to the PTT line by making use of the 
COM port. The circuit in Fig 3.6 is for a watchdog timer that during normal 
operation passes the DTR/RTS state straight though to the transistor con- 
trolling the PTT line. However, with the component values shown, after 
approximately one minute of transmitting the PTT line is released and the 
LED lights up to show an error or timeout condition. The 74HC14 has 
Schmitt trigger inputs and the time delay is generated as C2 charges until 
the voltage on pin 11 drops below the gate threshold point. 
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Fig 3.6. Watchdog 
timer for transmitter 
protection 


PTT Out 


RTS/DTR 2N7000 


T4HC14 


Timeout 


The circuit is self-powered via diode D1 and the 5.6V zener, making use 
of the fact that the RS232 line can quite easily deliver several milliamps of 
current. For a longer timeout period the value of the 470pF capacitor can 
be increased, although new, 25V working devices should be used here to 
keep leakage current as low as possible. By also increasing the value of the 
1MQ resistor, even longer timeout periods can be achieved. The 470Q re- 
sistor and D3 ensure a rapid discharge of C2 when returning to receive. 
The LED needs to be an ultra-high brightness type as only a couple of 
milliamps can be spared to operate it without excessively overloading the 
RS232 line. 


Automatic tuning and scanning 


One way of making use of the transceiver control port is to irfiplement a 
control panel on the host computer that allows memory functions, frequency 
shift working, fine tuning, and other functions to be made available that may 
not be present on the transceiver’s front panel. A number of software 
packages exist for this purpose, both available for purchase (often from the 
Fig3.7.Commander_ ‘tansceiver manufacturer) and as freeware. Fig 3.7 shows the screen dump 
rig control software of the freeware programme Commander, available for download from 
reference [2]. This can cope 
with most makes and types 
of amateur receiver or trans- 
ceiver, allows full frequency 
and mode control and im- 
plements 30 memories which 
contain all operating param- 


Devices _ 


i 


| Split 1 if eters, plus numerous other 
| donee functions. Some manufactur- 
as ms ; ers such as Ten-Tec make 
158 ATTY c completely ‘blind’, ie front- 
| C USB FM s panel-less, radios that make 


such a driver essential. The 
exclusion of manual controls 
such as tuning, volume and 


PEEEEREEEL! 
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bandswitching reduces the cost of 
the hardware and lets users cus- pga jal 
tomise their interface for personal | 
preferences. if lf E i | | a5 
yt ak 
bsanieg 6.000 to 8.000 MHz 640 Steps of 3.13kHz 


Spectral analysis 

The next step on from single fre- 
quency control is to set up soft- 
ware to sweep, or monitor, bands 
of frequencies. These may be, for 
example, complete amateur 
bands to look for activity on an 
otherwise dead band, or on parts 
of bands looking for specific sig- | LU 
nals. A simple spectrum analyser | | 1 | | 
can be generated by writing soft- | 
ware that steps across a band of 
frequencies in fixed channels, then, by using the receiver’s S-meter reading 
(this is often made available as a message back to the computer from the 
receiver), generates a plot of frequency versus signal strength. If signal 
strength information is not available as part of the software control com- 
mands, a separate analogue-to-digital converter can be used to monitor the 
AGC line or S-meter and feed its data back to the PC. A suitable A/D 
converter interface for this purpose is described in Chapter 4. 

Fig 3.8 shows the screen dump of a simple spectral analysis programme 
for the IC746. 

Where operation is channelised, such as in the FM sections of the VHF 
amateur bands, band monitoring is made even simpler. The receiver is 
stepped across the channels and a single one-wire interface from the squelch 
circuitry is all that is needed to tell the software the channel is occupied. 
This single line can be interfaced to the PC via one of the unused RS232 
handshake lines — such as CTS for example, or even by something as eso- 
teric as a pin on the game port; all can be read by software. 


Algorithms and techniques for detecting 
signals in noise 


Monitoring of beacons that are normally undetectable, but which can sud- 
denly come up out of the noise, can be a rather time-consuming and boring 
task. It would be a lot easier if we could automatically detect the presence 
of a weak carrier in noise and either sound an alarm or start some recording 
software. 

A simple threshold detector on the AGC line, or an audio filter followed 
by a tone detector as shown in Fig 3.9, is one means to detect signals that 
are strong enough to trigger the circuitry, but these techniques will not work 
for signals that are buried right down in the noise. 


Channel Dwell 50.0ms 


| th 


Fig 3.8.Screen dump 
of spectrum moni- 
toring programme 
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Determine the frequency spectrum 


Audio in 


from Detector A very sensitive carrier detection scheme 
receiver 


Signal : 
present | can be devised by using some of the dig- 


ital signal processing techniques that will 
be covered in Chapter 8, capable of gen- 
Pa barca erating a ‘signal present’ alarm at levels 
to tone Meet a cin that can barely be heard by ear. The heart 
ma pica of the detection process uses the fast 
Fourier transform, a software technique 
Fig 3.9. Filter plus covered in detail in Chapter 8, but for the purposes of this description it is 
tone detector for easiest to visualise the process as a software-generated bank of band-pass 
automatic signal de- ; in ey ate 
tection filters. When a block of successive samples of a digitised audio input wave- 
form are passed though the FFT process, the result is an array of numbers 
whose values are the amplitudes of each of the spectral components from 
DC to one half of the sampling rate. The bandwidth of each ‘band-pass 
filter’ term is defined by the block length. So, as an example, an audio 
waveform could be digitised at 10kHz and 512 samples passed into the FFT 
process at a time. The output would be 256 values of the spectrum from 0 to 
5kHz, in units of 10000/512 Hz, or approximately 19Hz. Fig 3.10 shows 

this. 

So we have filtered the input audio waveform from an SSB bandwidth 
down to around 19Hz, and more significantly we still have all the informa- 
tion in the original 3kHz available, so the need to accurately tune our signal 
to fit into a single 19Hz bandwidth filter has now disappeared. The ration- 
ale behind some of the numbers chosen for this example is coyered in the 
FFT description later, but we should note that the FFT size has to be a 
power of two, such as 256, 512, 1024 etc. 


Effects of noise 


We now have the array of numbers that indicate the signal power present 
in the 256 outputs of a bank of band-pass filters, each 19Hz wide, that cover 
our 0 to nominally 5kHz bandwidth — each one of these 256 values is termed 
a frequency bin, as in dustbin! This process is repeated at the block rate, so 
each set of 256 values is updated every 25.6ms. We now tune our receiver 

~ so the beacon frequency being monitored falls somewhere in the SSB pass 
band and, by monitoring the levels of each bin, when the signal appears, 
the value of the appropriate FFT bin corresponding to its tone frequency 
rises. If this exceeds a preset threshold an alarm can be sounded and what- 
ever action to log the result taken. But now we run into problems with 
noise. 

Noise is a random process and its frequency spectrum appears as many 
spikes at all frequencies, so in the absence of a real carrier, each FFT bin 
will be randomly outputting values, any one of which will be an instantane- 
ous local maximum which will vary randomly from block to block and is 
very likely to exceed the triggering threshold at some time. This is where 
statistical analysis starts to play a part. A genuine carrier falling into one of 
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the bins, even if it is only a fraction above the 
noise, will give an increased value for that bin 
but, if measured on its own (using one block’s 
worth of data only), it is almost certain to be 
swamped by noise spikes that can easily be 
much bigger in many of the other bins, and a 
simple level detection will not give reliable re- 
sults. The threshold can be raised to minimise 
these false alarms, but setting it too high means 
the signal has to be quite strong before it is 
detected. 


Audio waveform 
sampled at 10kHz 
with 512-point 
FFT applied 


Noise averaging 


The next stage is to average successive blocks 
of data. By calculating 256 separate moving 
averages for each of the bins over the last few blocks of data, we can build 
up a more accurate estimate of time-averaged energy in each of the bins. 
The averaged energy in each bin is now compared with the threshold and 
only if the signal in the same bin is high for several blocks will the alarm be 
sounded. This two-dimensional process, looking over frequency and time, 
goes some way to smoothing out the effects of noise and begins offer us a 
reliable automatic alarm when a signal appears. Visual spectral analysis 
programmes such as Spectrogram make use of time averaging in a similar 
way for detecting weak signal in noise, by making the human eye/brain 
combination look for the successive increased values in each bin. Greater 
reliability can be obtained by using a voting process. The signal in a bin has 
to exceed its threshold, say, three out of four times in a successive set of 
readings before an alarm is generated 

However, what happens if the noise level changes, such as happens on 
HF during the day/night transition or if broad-band interference appears? 
If the noise level rises too much while the threshold remains unchanged, 
there is a reasonable probability that even averaged noise could trigger the 
alarm — so we need some way of moving the threshold automatically. In 
other words we want to measure the signal-to-noise ratio in each bin rather 
than the absolute level. A way to measure S/N ratio is to sum the entire 
signal power across all the bins — this total gives the power in the entire 
input signal of signal plus noise. By making the assumption that a signal, if 
it appears, will only be in one or two bins at the most, by dividing the total 
power by the number of bins we get an approximation to the noise level in 
each bin. Now the time-averaged power in each bin can be compared to 
the effective noise level and the signal-to-noise ratio for each bin calculated. 
The highest S/N ratio, if it exceeds a threshold, can be considered a valid 
signal detection. 

There is another way of deriving the signal-to-noise ratio that does not 
require the calculation of the total power, is more immune to spikes and 
bursts of interference and is often computationally faster that summing all 
the powers in each bin. The technique relies on some of the statistical 


19.5Hz +9.8Hz 


39.1Hz 


58.6Hz 


4941Hz 


4961Hz 


4980Hz +9.8Hz 


Fig 3.10. The FFT 
technique for gener- 
ating a bank of ef- 
fective band-pass 
filters 
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Fig 3.11. Generating 
the noise level by 
statistical methods. 
(a) Raw FFT output. 
(b) Bins re-ordered 
into ascending order 


of amplitude 
Estimated 
noise level 
Amplitude 
ba2na 475) 607) 859 10 112 of lower 3° 18679) 5 7 AS 2102.8: 
quartile 
Lower 
quartile 
(a) (b) 


properties of white (Gaussian) noise that we do not need to go into here in 
any detail. When the FFT process has generated its 256 values, these are 
sorted into ascending power level and the value represented by the lower 
quartile — the point where a quarter of the bins contain lower values; for a 
256-point FFT, the 64th sorted bin is used. Statistical theory says that adding 
a value of 5dB to this gives the signal-to-noise ratio. Fig 3.11 shows this in 
more detail. 


Peak detector 

One final aspect that needs to be covered is that of signal bandwidth. We 
have assumed so far that the wanted signal will fall in just one bin — but this 
is far from being a valid case. A pure carrier could easily sit at tlfe crossover 
point of two bins, and each would give a valid answer. Furthermore, if the 
signal is modulated, even by keying sidebands, the modulation will spread 
into several adjacent bins. The solution is to detect peaks rather than single 
bin levels. ; 

One peak detection technique is to step across each frequency bin in 
turn, comparing it with the previous one. If three successive rises are fol- 
lowed by a drop, then a valid peak has occurred on the previous bin. Fig 
3.12 illustrates this peak-detecting algorithm. However, if the modulation is 
so wide that it spreads over many bins, this technique, which is really for 
detection of CW-type signals, is not really valid. 


Complete signal detection process 

We now have a multistage algorithm that can give very reliable detection of 
low-signal-to-noise, CW-type signals in a varying environment with a low 
probability of false alarms. The process can be summarised: 


1. Perform successive FFTs on blocks of data to generate the frequency 
spectrum of the input signal plus noise, and store these in an array. 

2. Take the frequency/amplitude original data for the current block and sort 
it into ascending order of amplitude. Take the value represented by the 
lower quartile and add 5dB to give the noise level per bin. The original 
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spectral data needs to be preserved, soa 
separate copy of the data needs to be 
generated for the sort process. 

3. For each block, step across each bin in 
the original (unsorted) data, looking for 
three rising values followed by a fall to 
indicate a peak. If this peak occurs at a 
signal-to-noise ratio greater than a pre- 
set threshold, then note the value of the 
bin where this peak occurs and store this 
value in an array containing the history of all peak detections from the 
last few blocks worth of data. 

4. Compare the bin number of each valid peak detection with the peak 
detections of the last few blocks’ worth of data using a voting system. If 
more than, say, three out of four peaks exceed the threshold successively 
in the same bin, then we have a very good assumption that a signal is 
present. 


This is a complex algorithm to design, but does give one of the most reli- 
able automatic signal detection routines in existence. By fine tuning each of 
the variables, bin size, number of bins, peak detect rising and falling values, 
S/N threshold and number of valid votes, it can be made to work for many 
of the signal types likely to be encountered. The order of some of the steps 
can be swapped around, eg storing valid peaks in the history array before 
comparing to a threshold, or some stages can be left out — the easiest way is 
just to try it and see! 


IARU beacon monitoring 


The IARU operates a chain of HF beacons across the world on single fixed 
frequencies in the 14, 18, 21, 24 and 283MHz bands. These beacons operate 
in sequence, each transmitting its callsign in CW for 10 seconds every three 
minutes, on each band in turn. The timings are controlled to extremely 
high accuracy by Global Positioning System satellite receivers, so at any 
instant it is possible to know exactly which beacon is transmitting on each 
band. BCNSCHED is a simple programme written by the author to allow 
easy monitoring of all these beacons; the PC’s internal clock is first syn- 
chronised with UTC to the nearest second. Then, based on a table of the 
beacon timings, the software shows which call should be transmitting at 
that instant. When a complete session is complete on one frequency, the 
PC then switches the receiver to the next frequency and starts the listening 
session. 

Although this programme was never actually finished, it could be en- 
hanced to monitor the S-meter reading for each time/frequency interval 
and log the results to either a file or graphical display, allowing a map of HF 
propagation throughout the world to build up. 

Fig 3.13 is a screen dump for this software showing how the data is pre- 
sented to the user. 


Fig 3.12. Peak detec- 
tion by looking for 
successive rising 
amplitude levels, 
followed by a fall 
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Fig 3.13. BCNSCHED 
screen dump 
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Automatic link establishment 


ALE is a process that has been used for some years by military and some 
commercial users of the HF spectrum, and involves automatically monitor- 
ing the path between a net of stations by sending and monitoring occa- 
sional probe signals transmitted by each station on each of the set of fre- 
quencies allocated to them. By measuring the strength of the received probe 
signals, which have of course to contain the identity of the transmitter send- 
ing each one, each station can build a continuously updated real-time map 
of propagation between itself and any station in the net. Thus, when com- 
munication is required the optimum frequency can be set aytomatically 
and the user can be insulated from the vagaries of HF propagation, choice 
of frequency, and sometimes even transmit power level; the HF link just 
appears as a normal voice channel. é 

The standards for this in the military world are now in the public domain 
and are encapsulated in a standard known as MIL STD 188-141A. Charles 
Brain, G4GUO, has written some software for the PC that fully implements 


this protocol by making use of the sound card to generate and decode the 


audio tones necessary to interface to an SSB transceiver for sending and 
reading the probe signal. Full control of the transceiver is possible, includ- 
ing transmit/receive switching, and tables can be set up of allowed frequen- 
cies which can be grouped for different nets. It is even possible to set re- 
ceive-only permissions on certain frequencies, such as those allocated only 
to different ITU regions. A wide range of amateur transmitters and receiv- 
ers can be controlled, and others can be added by Charles on request. Fig 
3.14 shows a screen dump of the PCALE software in use; it can be freely 
downloaded from G4GUO’s website [3]. 

One necessity for fully automatic transmit control is that of antenna tun- 
ing. The PCALE software can be set up to allow for antenna tuning time 
but this software, if it is used to transmit probe signals, presupposes an 
automatic ATU or broad-band transmit antenna is in use. A suitable auto- 


matic ATU is the Picatune by Peter Rhodes, G3XJP [4]. See Chapter 7. 
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GPS 


The GPS satellite system 


was mentioned in the pre- 
vious section as an aid to 


getting very accurate time 
information. GPS receiver 
modules are now readily 
available from a number of 
manufacturers [5, 6] that 
give a simple ASCII text 
output of positional infor- 
mation on an RS232 inter- 
face, along with time and 
date and various other bits 
of navigational data such as 


speed, as well as satellite sta-  prasaeeener eee aa - 


ee 


tus. The time as sent on the 
serial interface is usually ‘late’ by a few hundreds of milliseconds, as it is 
sent after the event, but this time stamp is associated with another signal 
available separately which supplies one pulse per second, with a timing 
accuracy better than lps. In some cases and with some modules designed 
primarily for time keeping rather than navigation, this accuracy improves 
to a few tens of nanoseconds. Thus is now possible for any amateur to 
identify an exact epoch of time, and know that the same trigger is happen- 
ing exactly at that instant anywhere in the world! This makes time-of-flight 
measurements of radio signals quite feasible and can allow ionospheric 
measurements to be made in real time. This aspect of GPS timing will be 
revisited in Chapter 7 where GPS is used for accurate frequency determina- 
tion, but here we are just concerned with reading the data from the serial 
interface. | 

The serial data is delivered in the NMEA0183 format, but is usually just 
referred to as NMEA, an abbreviation of ‘National Marine Electronics As- 
sociation’. This standard defines the data format and interfaces for all mari- 
time navigational equipment, allowing for it to be freely interconnected. 
The NMEA specification defines messages from instruments in the form of 
plain text in a sentence structure, and all sentences associated with GPS 
start with the letters ‘$GP’. Many GPS receiver manufacturers also add a 
few extra sentences of their own for additional information, such as satellite 
status and housekeeping. A typical block of data sent over the RS232 link 
every second is shown in Table 3.2, exactly as it appears when the NMEA 
output is displayed using a terminal programme such as Hyperlink. 

For our purposes, the first sentence beginning ‘$GPRMC’ is the most 
useful — this is the NMEA Recommended Minimum Specific GPS (RMC) 
sentence. Data items are separated by commas as follows: 


* The first item is the time, here 21:21:32 — this refers to the seconds pulse 
that has just happened. 


Fig 3.14. PCALE 


screen dump 
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Table 3.2. Typical NMEA sentences from a GPS receiver module 


— $GPRMC, 212132,A,5054.5876,N,00117.4041,w,000.0,000.0,141202,003.5 ,W*7B 
SGPGSAV A; 35m Ll te 2S 73 le Gh taase peat tee OO 
$GPGSV,2,1,06,03,23,146, ,11,64,276,40,14, 33,083,44,20,21,215, 36*74 

* The ‘A’ indicates a valid position — if not present the previous time may 

be in error. 

* The longitude in the format DDMM.MMMM, with leading zeros sup- 

pressed, here 50°, 54.5876' N. 

* The latitude in the same format, here 1° 17.4041' W. 

+ Speed over ground, knots (zero). 

* Course over ground in degrees. 

* Date in the form DDMMYY, here 14/12/2002. 

+ Magnetic variation (3.5°W). 

* A checksum, then the sentence is terminated with a carriage return 

linefeed pair, CR/LF. 


The GSA sentence gives some of the data used in the position calculation 
and its accuracy. The GSV sentence lists the satellites in view. The NUEA 
standard specifies a baud rate of 4800, but other rates are possible from 
most GPS modules — a faster rate may be needed if more sentences are 
requested than can fit in a one-second burst at 4800 baud. Any software 
written to use the NMEA information sentence has first of all to detect the 
start by looking for the string “$GPRMC”. It must then read in all data up 
to the CR/LF pair, then search for the positions of the commas, Once these 
are known the data can be extracted from between the commas using the 
knowledge of the sentence format. 
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Microcontrollers 


the simplest devices which can run stored programmes and ex- 

ecute actions based on the results. A microcontroller chip is usu- 
ally a small processor that includes its own programme and data memory, 
a range of peripherals such as a serial interface and timers, and drivers for 
input and output pins; they are often designed to be used in completely 
stand-alone applications. 

The first microcontroller chips were derived from microprocessors, first 
by including some on-chip memory and I/O drivers, then by adding vari- 
ous peripheral functions — devices based on these are in widespread use. 
For example, the original Motorola 6800 eight-bit microprocessor led to 
the 6805 microcontroller which is to be found in a number of automobile 
engine-management systems. Similarly, the 8080 family, which in one di- 
rection led to the PC, in another evolutionary branch became the 8051 
controller, widely used in many industrial applications today. Both have a 
huge base of legacy software and applications, and for this reason will con- 
tinue to be used for a long time to come. However, these traditional proces- 
sor-derived controllers were not always the ideal solution for simple low- 
cost projects. It was time consuming to write software for them and to re- 
programme or update; furthermore the traditional memory architecture 
was not the fastest solution for high-speed operation. So, in the nineties a 
new generation of dedicated microcontrollers appeared. These made use of 
a very straightforward architecture and a limited instruction set, that of a 
reduced instruction set computer (RISC) processor. They also operated with 
separate programme and data memory areas to optimise speed. One of the 
most popular of these dedicated microcontrollers was the PIC, developed 
by Arizona Microchip, although there are other close runners, the Atmel 
AVR and the 8051. 


M icrocontrollers are single chips that can probably be considered 


The Microchip PIC processor 


The first PICs were very simple 18-pin chips with 13 programmable I/O 
lines and a simple RISC instruction set that consisted of just 32 commands. 
Other versions had more I/O lines in packages with up to 40 pins but were 
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compatible in software. All PICs are made in CMOS technology with its 
consequential ultra-low power consumption when operated at low speed, 
ideal for battery applications, and can be used with a clock frequency up to 
20MHz for more demanding tasks. The first PICs had 1k of 12-bit wide 
programme memory and a few tens of bytes of user memory — the exact 
figures depending on the actual chip type. By separating the programme 
and data memory in the so-called Harvard architecture, the 1k limit is actu- 
ally a lot more use than it would be in a traditional sequential-memory 
architecture. Furthermore, dedicated programme memory means that for 
most instructions only (branches excepted) one clock cycle per instruction 
is needed. A 1MHz clock (generated on-chip from a 4MHz crystal) gives an 
instruction time of lps. Traditional architectures need, as a minimum, two 
and often more clock cycles per machine code instruction. 

Originally, PICs were made using EPROM technology that could be re- 
programmed after erasure using ultra-violet light; low-cost applications used 
one-time programmable chips without the expensive quartz window and 
ceramic construction that is required for an erasable version. Soon after- 
wards, a new technology was introduced — the first EEPROM PIC appeared 
and could be electrically reprogrammed at will without having to use a UV 
light source. This offered the possibility of being reprogrammed in situ, ie 
while mounted in its target circuit. The instruction set was increased to 35 
commands with a 14-bit word. The ubiquitous PIC P16C84 had appeared, 
which has been described as “the 741 of the microcontroller world” be- 
cause of its universal adoption. An enhancement to the production process, 
using Flash technology to reduce cost and improve reliability, led to the 
16F84 which is (very nearly) functionally identical to the P16C84 and is still 
the standard workhorse of the PIC world. This has 1k of programme memory 
and 68 bytes of data memory, 13 I/O pins, an internal timer with prescaler, 
64 bytes of user non-volatile memory, and four interrupt sources. It will 
work over the power supply range 2 to 6V with clock speeds of up to 20MHz 
on selected devices, and down to DC for low-power operation. At the low- 
est clock speeds, current consumption is just a couple of milliamps, and in 
sleep mode even lower, at a few microamps. The instruction set for the 
P16xxx series of PICs is shown is Table 4.1, and a simplified diagram of the 
architecture of the 16F84 device in Fig 4.1. Full data sheets and information 
are available from the Microchip website [1]. 


Programming the PIC 


Programming a PIC for any task is similar to writing in any other program- 
ming language, although much more knowledge of the target processor is 
needed. PIC programming in high-level languages such as C or Basic is 
possible, and many users prefer this route. The best compilers can hide the 
complexities of the chip but these versions can be quite expensive — low- 
cost, and even free or shareware, C language compilers do exist, but using 
these often gives little advantage over assembler. 

There is no doubt that for optimum processing speed and keeping 


Table 4.1. PIC 16Fxxx instruction set 


Byte-oriented file register commands 
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ADDWF f, d Add W tof, place result in d (f or W) 1 CAG 2 ce 
ANDWF f, d AND W with f, place result in d (f or W) 1 L i BA 
| CLRF f Clear f 1 LE. 2 
CLRW Clear W 1 ya 
| COMF f, d Complement, place result in d 1 Z AyD 
| DECF f, d Decrement f 1 v4 1,2 
DECFSZ f, d Decrement f, skip next instruction if zero 1or2 17293 
| INCFf,d Increment f 1 i Mee 
| INCFSZ f, d Increment f, skip next instruction if zero 1or2 eee 
| IORWF f, d Inclusive OR W with f 1 Z 1,2 
_MOVF/, d Move f to destination 1 Z PP? 
| MOVWF f,d Move W tof 1 
| NOP No Operation 1 
| RLFf,d Rotate left f through carry 1 G i es 
_ RRFf, d Rotate right f through carry 1 € 192 
| SUBWF f, d Subtract W from f 1 CDG Z {2 
| SWAPF f, d Swap nibbles in f 1 pe 
| XORWF f, d Exclusive OR W with f 1 va be 
| Bit-oriented file register commands 
| BCFf,b Clear bit B of register f 1 1,2 
BSF f, b Bit set f 1 ie 
_ BTFSCf, b Bit test f, skip next instruction if clear 1or2 3 
| BTFSS f, b Bit test f, skip next instruction if set 1or2 3 
| Literal and control operations 
| ADDLW k Add literal to W 1 (orm bleny4 
| ANDLW k AND literal with W 1 Z 
| CALL k Call subroutine 2 
/ CLRWDT Clear watchdog timer 1 
| GOTO k Go to address . 2 
_ IORLW k Inclusive OR literal with W 1 Zz 
_ MOVLW k Move literal to W 1 
| RETFIE Return from interrupt 2 
| RETLW k Return with literal in W 2 
| RETURN Return from subroutine 2 
| SLEEP GO into standby/sleep mode 1 
| SUBLW k Subtract W from literal 1 GDC Z 
_ XORLW k Exclusive OR literal with W 1 Z 
_ Notes 


| 1. When an 1/0 register is modified as a function of itself (eg MOVF PORTB, f) the 


| 


(ssiemnevineveesuansissintetsesisnnansinaxaesiteanteancioesteensabsoshenennan events desisteshsincancasatesachen 


/ present on the pins themselves rather than that stored in the output registers. 
2. Clears prescaler when executed on the TMRO register ) 
_ 3. If the Programme Counter (PC) is modified or a conditional test is true, the instruction requires two cycles. | 
| The second cycle is executed as a NOP. 


resultant code size small, as well as understanding all the device’s idiosyncra- 
sies, the native assembler is much more efficient than a high-level language 
such as C. For some tasks, however, such as string handling, a high-level 
language can prove more suitable. 


value used will be that value _ 
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Programme Programme Data bus 
Peony counter 
1k x 14 


Programme bus 


: RAM 
Instruction (User memory) Status 
register Local stack 36x 8 register 


Addressing 


Literal data 


Instruction Arithmetic | 1/0 ports —_| 
control 
Osc start up 
Timing ; é 
Watchdog timer 


1/O pins 


Fig 4.1. Simplified To develop PIC software (more correctly called firmware as it is embed- 
architecture for the ded into a final application) a personal computer of some sort is invariably 
baseline PIC control- ; ; ’ 

ler used to develop the code using various software tools supplied, usually free 


of charge, from the PIC manufacturers. A programmer driven from the PC 
is then used to load the developed code into the chip. Programmers of 
different sorts and levels of sophistication can either be purchased from 
most electronic component suppliers, or simpler ones capable of program- 
ming many, but not necessarily all, of the PIC processor types can be quite 
easily built. Most programmers run off either the parallel port or the serial 
port and some of the commercially manufactured units are now offered 
with a USB interface. Many popular low-cost devices are restricted to pro- 
gramming the 16F84 device. 
There are four stages to producing a fully functional PIC design: 


1. Design the circuit and hardware, making use of the PIC data sheets to 
determine which pins are to be used for each function —- many of the 
special peripheral functions require their interfaces to be on specific pins. 


2. Write the assembler code — the list of instructions to perform the func- 
tion required. This is in the form of an assembler (source) file in text 
format and usually generates a file with a name like xxx.ASM where xxx 
is the filename. There is usually a section that defines memory locations 
and register names and sets up peripheral functions, followed by the 
operating code itself. A range of INCLUDE files are provided by Micro- 
chip for each processor type to make naming programming easier by 
naming all the registers and individual control bits. On a PC, a text edi- 
tor such as Notepad or the DOS Edit command can be used to write the 
source code. 
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Table 4.2. PIC programmers 


PICSTART Plus Made by Microchip and available from many suppliers. Uses the 
serial port for interfacing and is driven through Microchip's MPLAB 
software which is a full PIC development suite available for the 
Windows operating system, including editor and simulation pack- | 
ages. . 


. 


i 

i 

| | 
EPIC Supplied by MELabs [2]. A simple programmer supplied as a PCB | 
with ZIF socket, making use of the parallel port. 
i 

| 


WISP628 A design for home construction that requires a programmed PiCas | 
part of the design. A chicken-and-egg situation arises here if this is | 
to be the first programmer, but ready-programmed PICs are avail- | 
able from the designer in reference [3]. 


3. Assemble the source code into machine code. The assembler generates a 
file xxx.HEX which contains the machine code in a form useable by the 
programmer. It also generates a full listing xxx.LST which contains a 
repeat of the source code with all associated memory maps, variables 
and labels shown. Any errors in the source code such as illegal calls, 
mistyped labels or variable names or illegal values appear in an error file 
xxx.ERR; this will be empty for a ‘perfect’ assembly. Warnings are also 
produced when certain operations that may cause potential problems in 
some circumstances are made. An excellent assembler is MPASM, pro- 
duced by Microchip, which can be downloaded from reference [1]. 

MPASM is called from the command line by invoking it along with the 
filename of the .ASM file, eg MPASM TESTPROG. After assembly is 
complete, it reports back on the number of errors encountered in the 
process along with any messages or warnings about the code. Details of 
these are stored in the .ERR file. 


4, Programme the chip. Most modern PICs are programmed serially by 
making use of three of the pins plus ground. The master reset pin is 
raised to +13V while the chip is powered normally from its 5V rail, and 
the data is clocked in serially using two pins, one for clock and the other 
for data. Programmers usually include a zero insertion force socket for 
programming raw chips, or provide the four connections needed for in- 
circuit programming. Microchip supply a range of programmers and 
debugging tools, but details of some low-cost ones suitable for home con- 
structors are included in Table 4.2. This list is by no means exclusive and 
many more PIC programmer designs can be found on the web. 


An intermediate stage between steps 3 and 4 is available — that of simula- 
tion. Host computer software takes the .ASM or .HEX files and simulates 
the functioning of the PIC hardware with the user code which can be single 
stepped if required, allowing all intermediate values, the state of all regis- 
ters and I/O lines to be examined at any time for debugging. Alternatively, 
breakpoints can be set and registers checked at this point. 

It is only a simulation, and the functioning of peripherals such as A/D 
converters has to be assumed. Timing and clock cycle count is shown 
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directly, a function which can be very tedi- 
ous if undertaken manually on the source 
code. 


LED flasher programme for the 
16F84 PIC 


As an introduction to PIC programming, a 
simple PIC programme is given in Table 
4.3 that flashes a LED. This is written for 
the 16F84 processor but will also run un- 
modified on many 16xxx types, although 
memory locations may have to be changed 
for later PIC devices with more peripheral 
functions on-chip that use up the lower 
memory positions. Note that this pro- 
; gramme will not run on the original base- 
Fig 4.2. Circuit dia- line 16C5x family devices with their 12-bit architecture without modifica- 
gram for PIC based tion. 
Beier All text after a semicolon is a comment, is not needed as part of the 
programme and is ignored by the assembler. The circuit diagram is shown 
in Fig 4.2. 


Detailed description of the PIC assembly code for the LED flasher 

The first section defines the processor type to the assembler and calls up 
the INCLUDE files that define all the internal registers and control bits. 
Next, data memory locations are defined as variables with meanifigful names. 
The CBLOCK command starts these allocations at address 0x0C as locations 
below this are taken up by the special function registers, such as the I/O 
ports and status register. 

The 16F84 PIC has 13 I/O lines, five on Port A and eight on Port B. Here 
we connect the LED to the lowest bit on Port B, referred to as ‘BO’, or 
PORTB, 0 as shown in the listing. To make life easier, and to illustrate good 
programming practice, a #DEFINE statement is used so that later references 
can just call up the LED pin by name. If it is decided to subsequently change 
the pin that the LED is connected to, all that is needed is one change to this 
#DEFINE statement rather than searching through the code for every occur- 
rence of PORTB, 0 and changing it. Within many of the listings and subrou- 
tines in this book, I/O lines and some other functions will usually appear as 
meaningful names without any corresponding #DEFINE being shown in the 
listing. Whenever this is encountered, a corresponding #DEFINE will have 
to be included at the start of the programme to define whichever port/pin 
combination is to be used. ! 

ORG 0 defines the start of the code at the beginning of programme memory, 
and here we use a trick which is good programming practice, although not 
essential. The interrupts on this family of PIC devices always causes a pro- 
gramme jump to memory location 004, just after the beginning. If inter- 
rupts are not being used and are disabled, this location can just be part of 
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Table 4.3. PIC programme to flash an LED 


| 


; LEDFLASH. ASM 


Startup 


MainLoop 


ishssats P=PIC16F84 ;Define processor type to assembler 

include P16F84.INC ;Include file for special function register and bit names 

cblock Ox0c ;Start of accessible data memory above special function registers 
DelCount1 ;Two variables used in the delay routine 
DelCount2 

endc 

#define LED PORTB, 0 ;Good practice and makes things easier later 

Org:: 0 ;Start of programme memory 

clrf INTCON ;Disable all interrupts by clearing interrupt control register 

goto Startup 

org 0x04 ;Interrupt vector 

retfie ;Just in case of accidental interrupt 

bsf STATUS , RPO ;Data memory Page 1 

mov lw b'11111110' ;Shown in Binary format 

movwf  TRISB ;BO as output for LED, rest inputs 

bcf STATUS , RPO ;Back to Page 0 

bsf LED 

movIw d'20' ;On for 20ms, number defined in decimal format 

call Delay 

bcf LED 


movIw  d'‘'250' 
call Delay 
movilw  d'250' 


call Delay 
moviw d'‘'250' 
call Delay 
moviw d'230' ;off for 980ms 


call Delay 


goto MainLoop 


Delay ;Delay W ms (approx) assuming 4MHz clock 


movwf Delcount2 


DelLoop2 ;Outer Loop 


mov lw d'200' 
movwf DelCcount1 


DelLoop1 ;Inner loop 5N-1 + 2 to set up = 5.N+1 
nop 
nop 
decfsz DelCountl 
goto DelLoop1 ;End of inner loop 


decfsz Delcount2 
goto DelLoop2 ;End of outer loop 


return 
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the normal programme flow. However, if by accident or programming error 
an interrupt is generated at any time and for any reason, a jump to this 
location will occur - usually with unpredictable or fatal results. Further- 
more, as this is the result of an error which may be completely remote in 
the code, its cause will be very difficult or even impossible to find. So, at 
location 004 we include a RETFIE command which immediately returns 
from any interrupt back to the correct place in the calling routine, causing 
no damage. Normal programme flow misses the interrupt vector and its 
return command by virtue of the GOTO StartUp command at programme 
memory location 000. 

At Startup, the direction of the ports is now defined. By default they are 
set as inputs and, as we want BO to be an output, we need to store a ‘0’ at the 
appropriate location in the Port B direction register, TRISB. Binary no- 
menclature b'11111110' is used here to make the bit pattern obvious on 
inspection, but it could equally well be defined in hex (OxFE or h'FE') or 
even in decimal (d'254). Data memory in this family of PICs is organised 
into banks, and the lesser-used registers are placed in Bank | with the com- 
mon ones in Bank 0. As the TRIS registers are in Bank | this has to be 
defined by the statement BSF STATUS, RPO which sets the appropriate bit 
in the Status register. It is cleared after TRISB is set. No other special func- 
tion registers need to be set up for this programme so we can jump straight 
into the code to flash the LED. 

A label, MainLoop, defines the start of this part of the code. The LED is 
first turned on with the BSF LED, or bit set command. Remember that the 
#DEFINE statement earlier really means that this translates to BSF PORTB, 
0. The W register, which can be thought of as a working ac€umulator, is 
then loaded with a constant value of 20 (decimal) to define the length of 
delay required, ie the duration the LED is turned on for. The delay subrou- 
tine (described later) is called, which holds up the main programme flow 
for approximately the number of milliseconds passed to it in the W regis- 
ter; when this is complete the software returns to the next command after 
the call instruction. The LED is now turned off with the BCF command (bit 
clear register F) and W loaded with the value to define the off time, here 
decimal 200. As we are using an eight-bit data word, the maximum value 
here is 255; we need a longer delay than 255ms so the call is repeated three 
times to make up a total of 980ms off time. The programme now jumps 
back to Mainloop and the process continues indefinitely, giving a 20ms 
flash every second. 

The De lay routine works as follows. The time delay is generated by putting 
the software into a loop with a controlled number of clock cycles. Assum- 
ing a 4MHz crystal, each instruction takes exactly lps apart from jumps, 
and some others that change programme flow, which take two clock cycles. 
There are two nested loops to generate potentially quite long delays — the 
inner loop starts at the first label, Loop1, and loads a constant into W which 
is then placed into the variable De] Count1. The DECFSZ command decre- 
ments this counter and tests to see if the result is zero — if so it skips the next 
instruction, otherwise it just continues. So, if the result is not zero the GOTO 
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command is executed which completes the inner loop. This loop is made 
exactly five clock cycles long by including two no-operation commands to 
extend the overall length to this value. The final jump out of the loop loses 
a spare clock cycle, but there are two taken up with the initial load of the 
constant, so the total length of the inner loop is 5.N+ 1 where Nis the initial 
value loaded into the De1Count1 variable. Here a value of 200 decimal is 
used so the inner loop completes in close to Ims. 

The outer loop works the same way, but the value passed into the Delay 
routine is loaded into the De]Count2 variable, so the inner loop with its 
Ims delay is executed this number of times. On completion the RETURN 
command passes programme flow back to the calling code, after generating 
a delay (nearly) equal to the value passed into it via the W register. The END 
statement is self-explanatory, and necessary! If more accurate timing is 
wanted, more attention has to be paid to the delay routines and it is here 
that simulation proves its value. However, the best way of obtaining accu- 
rate delays is to use the internal timer to generate an interrupt irrespective 
of code length, then rewrite the entire programme on an interrupt-driven 
basis. Some examples of this method of accurate timing are included later. 

Little tricks like using binary or decimal nomenclature for numbers, add- 
ing numerous comments, indenting and separating sections of code with 
spaces or lines makes producing PIC assembler code that works first time 
easier; it certainly makes debugging simpler. 


Interfacing to PCs — a serial interface 


One of the many useful functions for PICs in the amateur radio world is to 
simplify input and output from PCs for data logging and control purposes. 
In Chapter 3 we showed how PC interfacing could be achieved through the 
parallel and serial ports. PICs can be used to convert these formatted sig- 
nals into real-world control and data, for example driving relays or reading 
voltage levels. 

The listing given in Table 4.3, together with the circuit of Fig 4.3, shows 
a 16F84-based design to read an eight-bit byte sent over an RS232 link, 
decode this data and drive eight data lines, one corresponding to each bit of 
the data. These in turn drive buffers for relays. For error checking the data 
is returned over the RS232 link so the PC can compare that sent with the final 
state of the latches. A LED is flashed for each byte received to assist in 
debugging. As the 16F84 has no internal circuitry for handling serial data, 
this task is managed in software. On receive the programme sits in a loop 
looking for the ‘1’ to ‘0’ transition associated with a start bit but, as this circuit 
interfaces directly to the RS232 signal, voltage polarities are opposite to their 
logical equivalents, and the ‘unofficial’ 0/5V levels are adopted on the RS232 
link. When the edge is detected, the software waits for half a baud period so 
the sampling instant is located at the middle of the data bit. The signal state 
is then checked again to make sure that the start bit is still valid, and if so the 
eight data bits are read by counting one baud intervals then shifting the result 
into the receiving register. After eight bits have been received, the data is 
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Table 4.3. RS232 relay driver PIC source code 


: RELAYDRV.ASM 
; Receives byte on RS232 line at 1200 baud, outputs data to Port B, 
; flashes LED then returns data on RS232 line 


LIST P=16F84 
__config Ox3FF1l ;Set crystal oscillator, wDT off, PUT on 


INCLUDE "p16F84.inc" 
cblock Ox0C 


BitCcount 
DelCount | 
DelCcount1 
DelCount2 
Temp 
Counter 
endc | 
#define RXD PORTA , 0 ;Serial data in from PC | 
#define TXD PORTA , 1 ;Echoed data / status out to PC 
#define LED PORTA , 2 | 
org 0 
nop : 
clrw 
movwf INTCON ;disable interrupts 
goto startup ;jump to main code 
retfie ;Interrupt vector, Just in case 
startup 
bsf STATUS, RPO ;ram page 1 $ 
mov lw b'00000001' s 
movwf  TRISA ;set port AO as input for RS232, rest outputs 
moviw  b'0Q0000000' ;All outputs for relay data 
movwf  TRISB : 
bcf STATUS, RPO ;ram page 0 
clrf PORTB “Start with all off | 
MainLoop 
call WaitData ;wait for character on RS232 line 
movwf  PORTB ;Place received character on relay driver port 
bsf _ LED ;Flash LED for duration of returned character i 


movf PORTB, W ;Get relay data to WwW 
call Send232 ;Send data back to Pc for checking 


bcf LED ;Vvey quick flash 
goto MainLoop ;Continue indefinitely 

BitDelay ;total incl call and return, (3N+5) = 44us 
moviw  d'‘13' ;+8 used in Tx/Rx routines = 52us 
movwf Delcount ; for 19200 baud 

LoopBit 
decfsz DelCcount 
goto LoopBit 
return 

| WaitData 
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Table 4.3 (continued) 


btfss  RXD ;look for start transition, low/high = 1/0 
goto waitData 
moviw d'‘7' 
movwf DelCount 
nop 
| LoopStartBit ;this loop 3.N - 1 long = 17 
decfsz DelCount 
goto LoopStartBit 


i 

i 

. 

| 

btfss RXD smake sure it's still high, now centre of bit 
goto waitData 

moviw 8 

: movwf Counter 

cirf Temp ;26us to here from transition = half bit 
| ByteLoop 

j call BitDelay 

nop 

f bcf STATUS , C 

btfss RXD 

bsf STATUS 6 

i Crt Temp 


i decfsz Counter 
goto ByteLoop ;this loop BitDelay + 8 


movf Temp , w ;Returns with stop bit+ slack period 

return ;received byte in Temp and w 

Send232 ;Enter with data in W, send it to PC 

movwf Temp 

| bsf TXD *start bit 

: call BitDelay ;44us, need 52 total 

moviw 8 

movwf Counter 

: nop 

nop 

nop 

| SendDatLoop 

ref Temp ;bit into C 

| btfsc STATUS iis 

bcf TXD 

i btfss STATUS ~,. © 

i bsf TXD ;could have 2us jitter depending on 1/0 

call BitDelay 

i decfsz Counter 

goto SendDatLoop ;loop 8 + BitDelay long 

bcf TXD sstop bit 

i call BitDelay 
nop | 
| nop | 
nop ) 
nop 
| nop 
nop 

| - return | 
| 
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Fig 4.3. RS232 controlled relay driver 
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then sent directly to Port B to drive the 
relays. For checking, the port register 
is read then the result is encoded by a 
shift and bit set/reset loop timed at 
one baud duration. At 19200 baud, 
timing is quite critical so machine cy- 
cles for the RS232 send and receive 
routines have been tailored to be accu- 
rate to the nearest two cycles (2ps) 
which is acceptable. For higher reli- 
ability, a lower baud rate could have 
been chosen, and the BitDelay rou- 
tine modified accordingly. 

The routines Send232 and 
waitData occur within many pro- 
grammes in this book whenever .an 
RS232 link is required, and will not 
always be shown in listings to save 
space. In most cases the variables as- 
sociated with these routines will have 
the same names but the pins and port 
bit allocations may change. Many of 
the more-modern PIC devices, such 
as the 16F628, have universal syn- 
chronous/asynchronous receiver 
transmitter (USART) hardware for 
handling RS232 links, and for other 
serial formats. A dedicated USART 
makes programming a lot easier, par- 
ticularly as the processor can be doing 
other jobs while waiting for the serial 
characters to arrive instead of sitting 
inside an endless loop just waiting for 
data. On the downside though, baud 
rates are fixed to a few standard val- 
ues, the I/O pins allocated to the serial 
interface are usually fixed and signal 
polarity is such that an RS232 driver 
chip, or at least a logic inverter, is 
necessary to interface to the usual se- 
rial port. 


Analogue/digital 
conversion 


Some PIC devices such as the P16C71 
have an internal eight-bit A/D 
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serial A/D converter chips suitable for interfacing to PICs 


TLC549 45k. 3-wire Clock, Data, CS _ 


8 1 
MCP3201 8 12 1 100k _ 3-wire Clock, Data, CS 
MCP3202 8 a2 2 100k 4-wire, Clock, Din, Dout,CS_ 
_ MCP3204 14 12 4 100k 4-wire | 
| MCP3208 16 12 8 100k 4 wire | 
LTC1286 8 Ve 1 (differential) 12.5k 3-wire 
LTC1298 8 12 2 11.1k 4-wire 
MAX1236/7 8 12 4 100k 2-wire I2C 
: MAX1238/9 1 


6 12 i 100k 2-wire I2C ) 
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converter included. This particular chip can accept up to four analogue 
inputs, one of which can be measured at any time by addressing an internal 
analogue multiplexer. The A/D reference may be provided either exter- 
nally on one of the analogue input pins, or the +5V rail internally may be 
used as a reference. Other chips such as the 16C710 also have A/D con- 
verters but with slightly different characteristics - some recent devices have 
higher-resolution 10-bit converters and the relevant data sheet should be 
consulted for the exact operation in each case. 

Instead of these PIC devices, an external A/D converter chip can be 
connected to provide functions not available on the devices with internal 
converters such as a higher resolution or more analogue input lines. There 
are a great number of suitable serially controlled devices which interface 
with their host processor through two, three or sometimes four signal lines, 
typically data, clock and strobe; several devices make use of a two-wire I2C 
bus which is described later. 

Another advantage of using an external A/D converter is that software 
can be written for the Flash reprogrammable 16F84 which does not have its 
own A/D converter, saving the need for an EEPROM eraser every time the 
chip is to be reprogrammed. Some suitable serial A/D converter chips are 
listed in Table 4.4. 


Serial port A/D interface 

The circuit shown in Fig 4.4 is for an interface that samples an analogue 
signal using the internal A/D converter of a PIC 16C71, then outputs the 
binary data on a serial RS232 interface. Although originally designed for 
digital signal processing and sampling of audio waveforms, it can be used 
for measurements down to DC. 

The signal can be sampled at two rates of 100ps or 140ps between meas- 
urements. For DSP purposes the accuracy of the sampling rate is critical, 
and this is set by fine tuning the PIC code to give exactly the rate required. 
At 100ps sampling, 10000 eight-bit samples are generated each second and 
these have to be sent at a suitable rate on the RS232 interface. The fastest 
rate that most PCs will accept is 115200 baud so, by adopting a format of 
one start, eight data and two stop bits, 11 baud periods per sample are 
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Fig 4.4. Serial port required, allowing a maximum data rate of 115200/11 = 10472 bytes per 
HYNES second. Hence a sampling rate of 10000Hz is feasible with a small amount 
of timing or processing overhead. 

The source code listing is shown in full in Table 4.5 and was originally 
written by Lee Wiltshire, GOIAY. At this high data rate we cannot afford the 
luxury of calling dedicated RS232 subroutines as there is very little spare 
time available for the calls and returns. 

Instead, the serial bits are hard coded in one single loop that is exactly 100 
clock cycles long in total to give a 10000Hz sampling rate. The internal A/D 
converter needs at least 85 clock cycles for its internal operation so, instead 
of triggering a conversion then waiting for it to complete, the data sent is that 
of the last conversion. 

So the process now becomes: 
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Table 4.5. Full source code listing for the analogue-to-serial Interface 


Software to sample data at RA1 at 10kHz, and output it serially at 115.2kbaud to a PC 


;Original written by Lee wiltshire, GOIAY 
LIST P=16C71 
INCLUDE "P16C71.INC" 


sport A is used as follows: bit 0 - 
: bi tek a 
; bit 2 - 
: bit 3 - 
;port B is used: 


bit 7 - RS232 output (TTL Low = 


not used (tie to ground 

analogue input 

not used 

Vref 

RS232 +ve using interface) 


cblock 0x0c 


bits 6 - 0 not used (set to inputs) 


;Reading from LAST A/D conversion 


sinterrupt 


LAST_RDG 
TEMP 
endc 
org 0 
nop 
clrw 
movwf  INTCON 
goto startup 
retfie 
startup 
bsf STATUS, RPO 
mov lw eye a Dl aH 
movwt TRISA 
moviw  b6'01111111' 
movwf PORTB 
bcf STATUS, RPO 
moviw  b'10000000' 
movwf PORTB 
setup the A-D here 
movlw  6'01001001' 
movwf §ADCONO 
bsf STATUS, RPO 
movilw  b'00000010' 
movwf ADCON1L 
bcf STATUS, RPO 
onion LAST_RDG 
loop 
bsf ADCONO , GO 
movilw  b'00000000' 
movwf PORTB 
nop 
nop 
nop 
nop 
Gint TEMP 
net LAST_RDG, 1 
rrf TEMP, 1 
mov TEMP,O 
movwf PORTB 
nop 


;disable interrupts 
;jump to main code 
service: routine code 


;ram page 1 
;set port a as inputs 
;set Port B:7 as output, PB6-0 input 


;ram page 0 
;set RS232 to quiescent state 


ynad = ‘fosc/8, chi, A/D‘on 


;set RAO,1 as analogue, RA2,3 as digital 


;Entire loop should be exactly 100 cycles long 
;set conversion going whilst we send last sample 
31 start bit 
;bit time is 8.67us, so we will have +/- 0.5us jitter 
;this bit 9us 


;clear output reg (not absolutely necessary) 
;rotate bottom bit to carry 
;rotate carry into top bit 
;get ready to output 

;and output bit 

;this bit 9us (bit 0) 
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Table 4.5 (continued) 


crf 
Rei 
movf 
movwf 
nop 
nop 
nop 
Ghit 
rit 
net 
movf 
movwf 
nop 
nop 
nop 
nop 
Cher 
alg 
TEE 
movf 
movwf 
nop 
nop 
nop 
nop 
Chet 
Left 
crf 
movf 
movwf 
nop 
nop 
nop 
clrf 
FER 
rrf 
movf 
movwf 
nop 
nop 
nop 
nop 
Girt 
a i 
ref 
movf 
movwf 
nop 
nop 


TEMP 
LAST_RDG, 1 
TEMP, 1 
TEMP ,O 
PORTB 
;this bit 8us (bit 1) 


TEMP 
LAST_RDG, 1 
TEMP, 1 
TEMP, 0 
PORTB 
;this bit 9us (bit 2) 


TEMP 
LAST_RDG, 1 
TEMP, 1 
TEMP, 0 
PORTB 
;this bit 9us (bit 3) 


TEMP 
LAST_RDG,1 
TEMP, 1 
TEMP, 0 
PORTB 
;this bit 8us (bit 4) 


TEMP 
LAST_RDG, 1 
TEMP,1 
TEMP,0O 
PORTB 
;this bit 9us (bit 5) 


TEMP 
LAST_RDG,1 
TEMP, 1 
TEMP,0O 
PORTB 
;this bit 9us (bit 6) 
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Table 4.5 (continued) 


~clrf TEMP 
nick LAST_RDG,1 
lake TEMP, 1 
movft TEMP, O 
movwf  PORTB 


nop “this bit. Sus (bit 7) 
nop 

ielane LAST_RDG,1 

Ret TEMP, 1 


movf TEMP,O 
_movlw ~b'10000000' 
movwf  PORTB ;this bit at least 13us - Stop bit 


movf ADRES ,O swe had to wait at least 80us before getting result 


| 
| 
| 
| eink TEMP 
i 
i 
| 
| 
' 
; 
i 
{ 
| 
{ 
i 
i 
t 
i movwf LAST_RDG 


goto loop ;do this forever (99 instructions (100 cycles)) 
END 


1. Trigger the A/D conversion process 

2. Send the previous data from LAST_RDG, using the time taken for the 
serial byte to be sent for the A/D to complete its conversion. 

. Read the A/D converter 

. Write the result to LAST_RDG. 

. Repeat loop continuously 


Oa & 


The PC software has to either read the data at the rate it is being supplied 
(10000 samples per second) or in bursts by enabling and disabling the serial 
interface as required so that data arriving at the serial port is discarded. The 
accurately defined 10kHz sampling rate means this interface is suitable for 
digital signal processing type functions on the PC which are covered in 
more detail in Chapter 8. 

An enhanced version of this interface can be used in conjunction with 
some dedicated PC software for audio signal measurements. 
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Asien D/A conversion 


output If an analogue output is needed from the PIC 
software then some sort of external converter 
is always needed as no PIC devices at present 
include a D/A converter. 

Several routes are possible for this task, and 
which one is chosen depends on a number of 
factors, such as how many I/O pins are avail- 
able, how fast the conversion has to be per- 
formed, and the required resolution or accu- 
racy. 

In order of decreasing speed of operation, 
the main options are: 


1. External parallel D/A converter chip. An eight- 
bit device takes up eight I/O pins and con- 
version is usually made as quickly as the 
word can be written to the I/O port. A low- 
cost alternative is to use an external R/2R 
ladder made up from a discrete chain of 
resistors, such as that shown in Fig 4.5. 

2. External serial D/A chip. These use two or 
three serial lines in the same way as serial 
A/D converters. They are slower than a 
parallel type as the data has to be clocked 

Fig 4.5. External out from the PIC into the D/A chip, but higher resolutions %re possible, 

R/2Rladder for low- at least to 16 bits. 

cosemiAconvert®t 3. Pulse width modulation. This requires only an external resistor/capacitor 

for filtering. The PIC software generates a pulse at a regular timed inter- 
val — ideally by making use of the internal timer with interrupt-driven 
software. The width of this pulse is made proportional to the digital value 
being represented, so that the average level of the output waveform then 
varies in proportion and is updated at the pulse repetition rate. This is 
the slowest of the three D/A conversion methods, but only requires one 
output pin and a minimum of external hardware. A generic subroutine 
for generating PWM is given in Table 4.6 — this routine should be called 
at regularly defined intervals, and the unit delay interval adjusted to pro- 
duce an output waveform with a useable min/max duty cycle. For exam- 
ple, if the routine is called every 10ms a suitable unit delay would be 
38p1s as the maximum duty cycle would then equate to 255 x 38ps = 
9.69ms, very close to a 0 to 100% duty cycle variation. 


Displays and I/O for microcontrollers 


Some sort of manual input and output of data is very often needed in any 
project making use of a microcontroller. This may be as simple as reading 
the state of a pushbutton switch with output to a LED being turned on or 
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Table 4.6. Generic subroutine for generating a pulse width modulated output 


PWM ;Enter with 8 bit value in W register 
movwf Temp | 
; “btfsc) STATUS,. Z ;If zero, don't do anything 
| goto GetOutPwM ;Could use return statement here, but that is 
i .}  inelegant programming technique ! 
eeclrf) counter ;Effectively loads 8 bit counter with a value of 256 
i bsf PWMLINE ;Initially set PWM output high 
| PWMLoop | 
decf Temp ;Decrement vales each pass through loop 
btrse: STATUS, Z ;Reset PWMLINE when loop has passed through enough 
bcf PWMLINE ; times to decrement value to zero 
call  PwMDelay ;Or use nop statement(s), adjust delay to give a useful 
decfs Counter ; min / max duty cycle. 
goto PWMLoop ;Always 256 loops 
| GetoutPwM 
| return 
p 1 Se BE A SAD At ERD ae ne ODI ee ace Rte Seer Le Ene ON eee 


off, or as complex as an alphanumeric keyboard with a text-based display 
module. The PIC family of microcontrollers has been designed with I/O 
very much to the fore, and some hardware features are included to simplify 
interface to keyboards and switches. 


Switch and keyboard input 


Fig 4.6 shows two switches connected to a pair of pins on a PIC controller. 

All device families have a facility on PORTB to set an internal pull-up to the 

supply rail, so that no external resistor is required. This pull-up, which aaa ELutoT 
consists of a current source of approximately 100pA per pin, is activated by switches to PortB. 
clearing the RBPU bit in the PIC Option register. Another useful facility is PortB has internal 
the Port B change interrupt. By setting the Interrupt Control register Serie Heel teelget 
appropriately, any change from ‘0’ to ‘1’ or from ‘1’ to ‘0’ on any of Port B4—_— quired 

B7 pins will generate an interrupt. In conjunc- 
tion with the Wake-up on Interrupt function, 
this facility is invaluable for hand-held devices 
requiring ultra-low power consumption with a 
long battery life. Wake-up on keypress is set up 


as follows. 


1. The circuitry around the keyboard interface 
is arranged to change the state of one or more 
of PortB 4-7. 

. Wake-up on Interrupt is enabled. 

3. The processor is put into sleep mode where 

is consumes very little current. 

4. When a key is pressed, the processor wakes 
up and reads the state of PortB to see which 
switch was activated. 

5. Any action is performed and the software 
then goes back into sleep mode. 


iS) 
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The single switches can be replaced by a matrix-based keyboard, with the 
columns connected to ports B4—B7 and the rows driven by BO-B3, each 
pushbutton switch being connected across a row/column intersection. Be- 
fore entering sleep mode, all BO-B3 outputs are set to a low state and the 
pull-ups are enabled. Now, if any one of the 16 possible keys in the matrix 
are pressed, one of the B4—B7 lines corresponding to the appropriate col- 
umn is pulled low and the processor wakes up. By scanning a ‘1’ across 
each of the BO-B3 in turn and reading the resultant state of B4—B7, the 
button that was pressed can be determined. A hand-held remote control 
interface using this technique is shown in Fig 7.1. 


Display output 

Apart from single status LEDs or other simple types of output, alphanu- 
meric data can be presented to users on seven-segment LED displays, or by 
a dedicated LCD ASCII text module. LED displays are usually operated in 
multiplexed fashion, where one port drives the segments and another port 
is used to address each digit in turn. By switching from one digit to the next 
rapidly enough, the display can appear to be on continuously. If the seg- 
ments are driven directly from the PIC then seven pins are required, or 
eight if the decimal point is included. One pin is needed for each digit so it 
possibly to rapidly use up all the I/O pins just on the display alone. How- 
ever, for driving just a couple of digits for example, no extra circuitry is 
needed and this is the simplest solution. 

One way to save pins is to make use of a BCD to seven-segment decoder 
chip like the 74HC47 to drive the segments, which then only gequires four 
lines to be allocated — all 10 digits are available as well as a few special 
symbols and a blank. 

The driver chip concept can be extended further by using a binary de- 
coder like the 74HC138 to decode one line at a time from a BCD digit 
drive. Using this technique we can now drive up to eight seven-segment 
displays by using just seven I/O lines, four for the segments and three for 
digit selection.. However, the requirement to provide decoded positive drive 
for one side of the matrixed display — usually the digit anodes — does mean 
that extra driver hardware in the form of some PNP transistors and a hand- 
ful of resistors is now needed, increasing hardware complexity. The GPS 
clock circuit, shown later as Fig 7.7, details how a complete decoded and 
multiplexed display is connected. Software to drive the display has to call 
up the data for each digit in turn and place this on the segment drive pins. 
Then the code for that digit has to be placed on the address pins, the whole 
sequence being repeated continuously at a constant rate to avoid flickering 
or brightness differences. The generic code for driving a fully decoded dis- 
play is listed in Table 4.7. 


LCD modules 
For a more flexible alphanumeric output, modules are readily available 


that take ASCII codes and display them directly, with all decoding and 
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Table 4.7. Software for driving multiplexed seven-segment display 


: DisplayLoop ;Often part of MainLoop, 

movf D1, W ;Get first digit value, address 0 
andIw b‘'00001111' ;mMask to lowest bits just in case 
movwf PORTB 

; call MpxDelay ;Low enough to reduce flicker, say ims 
: movf D2, W 

i andlw b'00001111' 

| jiorlw b'00010000' ;Address of second digit 

call MpxDelay 

movf D3, W 

andiw b'00001111' 

i jorlw b'00100000' 

call MpxDelay 


i 


| movf D8, W 

andIw. b'00001111' 

iorlw b'01110000 

call MpxDelay 

{place other service functions here, eg reading data, switches etc.} 
goto DisplayLoop 

{ 


display formatting being taken care of by a dedicated display controller 
chip. Modules are manufactured in a wide range of sizes from one line of 
20 characters up to several lines of 80-character length. The first were those 
produced by Hitachi, but many different manufacturers have since adopted 
the concept, with several having retained the original set of commands and 
set-up codes — these are not elegant from a programmer’s point of view but 
are now an industry standard. 

All have the same hardware interface. An eight-bit or four-bit wide data 
bus is used to enter the character data — the width is defined in the first set- 
up codes to be sent and some crafty coding is needed to allow these to be 
decoded properly before the width is defined. Other lines needed are a 
register select line and a data strobe. A read/write line is also included, 
allowing data to be read from the module (the data lines can be bi-direc- 
tional), but for simple display purposes this is usually tied to ground — logic 
‘0’, the write state. So, as a minimum, six wires are needed to drive these 
display modules in ‘nibble’ (four-bit) mode, and 10 for byte-wide mode. 
However, by suitable circuit design, the data lines can be used for other 
functions such as driving serial peripheral chips as these lines are redun- 
dant, and their state irrelevant, when the LCD module is not being ad- 
dressed or written to. Of course, the other function or chip must be unaf- 
fected by the data lines changing as the display is addressed, usually en- 
sured by dedicating a separate strobe or clock signal. 

Table 4.8 lists the lines of code necessary to set up and initialise a typical 
LCD display module. Characters are subsequently sent to the display by 
loading their ASCII code into the W register and calling the DataByte 
routine. Functions such as carriage return, clear display etc are not 
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Table 4.8. Software for setting up and driving Hitachi-type LCD displays 


;LCD Display Driving and Set up routines. 


#define LCDRS PORTB, 1 ;Register select 
#define LCDRW PORTB, 2 
#define LCDE PORTB, 3 ;Strobe line 
#define LCDPORT PORTB ;Data lines on bits 4-7, nibble (4bit) mode 
LCDInit 
movlw d‘'10' ;50ms start up delay called up by specification. 
movwf Counter 
StartDel 


call Delay5 
decfsz Counter 
goto StartDel 
moviw 0x30 


movwf  LCDPORT ;R/W - Write RS =O €E = Low 
nop 
bsf LCDE ;First send three $30's, separated by 5ms 
nop 
bcf LCDE ;strobe in first $30 
call Delay5S 
bsf LCDE 
nop 
bcf LCDE ;second $30 
call Delay5 
bsf LCDE 
nop 
bef LCDE third $30 * 
call Delay5 
movlw 0x20 ;set nibble node 
movwf LCDPORT 
nop 
bsf LCDE 
nop 
bef LCDE 
nop 
moviw 0x28 ;Sets 4bit, 2 lines 5x10 dots 
call cmdByte 
movlw Ox1c ;Set display shift, shift right 
call “CmdByte 
movilw Ox0F ;Display on, Cursor on, Blink 
call cmdByte 
mov lw 0x04 ;Increment cursor 
call CcmdByte 
moviw 0x01 ;Clear and Home 
call cmdByte 
call Delay5 
return 
| CmdByte ;Send command byte (RS =0) 
movwf Temp 
andlw OxFO ;mask to high order bits 


movwf LCDPORT 
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Table 4.8 (continued) 


nop 
bsf 
nop 
bcf 
nop 
swapf 
andlw 
movwf 
nop 
bsf 
nop 
bcf 
call 
return 


DataByte 


call 


goto 


, a 

ShortDe lay 
mov lw 
movwf 


decfsz 
goto 
return 


LCDE 
LCDE 
Temp , w 
OxFO 
LCDPORT 


LCDE 


LCDE 
ShortDelay 


Temp 
OxFO 
LCDPORT 
LCDRS 


LCDE 
LCDE 
Temp , w 
OxFO 
LCDPORT 
LCDRS 


LCDE 


LCDE 
ShortDelay 


3 fags es 
Temp 


ShortDe lay 
Temp 
deloop 


dia2" 
DelCount 


Delcount 
deloop2 


| 
| 
i 


j 
| 


;Strobe in high order nibble 


;load low order nibble 
;mask to high order bits 


;Strobe in low order nibble 


;Normal Data byte with RS = 1 


;mask to high order bits 


;Strobe in high order nibble 


;load low order nibble 
;mask to high order bits 


;Strobe in low order nibble 


;5ms delay 


;Don't use DelCount here, it's needed below! 


;41us delay for strobe pulses etc. 


77 


COMMAND ~- Computers, Microcontrollers and DSP for the Radio Amateur 


78 


implemented with their ASCII equivalents, but are generated by calling the 
CmdByte routine with the appropriate generic code. 


The Atmel AVR controller 


The Microchip PIC is not the only microcontroller available for experi- 
menters, although it is probably the best-known one, albeit not the fastest. 
For significantly higher operation speed, Atmel’s AVR microcontrollers 
come in. These have a RISC core running single-cycle instructions and a 
well-defined I/O structure that limits the need for external components. 
Internal oscillators, timers, UART, SPI, pull-up resistors, pulse width modu- 
lation, ADC, analogue comparator and watch-dog timers are some of the 
features included within AVR devices. AVR instructions are tuned to de- 
crease the size of the program, whether the code is written in C or assembly 
language. With on-chip, in-system programmable Flash and EEPROM, the 
AVR is a perfect choice in order to optimise cost and get product to the 
market quickly. 

The AVR series of microcontrollers was designed with speed and ease of 
programming in mind. They use a reduced instruction set (RISC) architec- 
ture which is optimised for speed and code density. The models with SRAM 
have a well-developed stack structure which is specifically designed for 
compact code generation from C compilers. 

AVBRs use a Harvard architecture which, as noted earlier, means that the 
program memory and buses are separate from the data memory and buses. 
AVRs, like PICs, have a series of models with differing feature sets. The 
family was made popular by the AT90 series of parts. Thesewall have the 
following features: 


¢ In-system programmable 16-bit wide Flash program memory. 

* 32 general-purpose registers (usable for arithmetic instructions and as 
memory). 

* One or two counter/timers (eight-bit/16-bit) with various programmable 
clock sources and prescalers. 

¢ A variety of interrupt sources including external inputs, counter/timer 
overflow, UART and analogue comparators. 

° Watchdog timer to guard against code crashes. 

¢ Several power-down modes for battery-saving operations. 


The members of the family have the on-board features shown in Table 4.9. 
The AVR architecture allows most instructions to execute within a single 
clock cycle. This enables the 12MHz versions to execute code at almost 
12MIPS which is an astonishing speed for this class of processor. 
Reasons to use the AVR include: 


* RISC architecture allows very fast and powerful applications. 

* Good development support with assemblers, Basic and C compilers. 

* Ease of development with in-system programmable Flash program 
memory 
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Table 4.9. Atmel AT90 family features 


AT90S1200 20 8 512 = 64 15 


1 2 yes 
AT90S2313. 20 ~~ 1k 128 128 15 2 2 yes yes 
AT90S2323 8 1k 128 128 3/5 1 1 | 
AT90S2343 8 1k 128 128 3/5 1 1 | 
AT90S4414 40 2k 256 256 32 2 2 yes yes 
AT90S8515 40 4k 512 512 32 2 2 yes yes | 


° Sophisticated reset and interrupt handling makes for advanced program- 
ming. 

* High level of on-chip peripherals — especially on the 20-pin AT90S2313. 

* Several levels of power management which are excellent for battery- 
powered applications. 


An application that makes use of the high-speed capability of the AVR is 
the MiniDDS application designed by Jesper Hansen and described in more 
detail in Chapter 7. It is an excellent example of the processing speed of the 
AVR processor, allowing a low-frequency direct digital synthesiser to be 
implemented in software at a surprisingly low cost. When run at the sug- 
gested clock frequency of 11.06MHz the DDS can generate accurate sine, 
triangle, sawtooth and square waves at all frequencies from 0 to over 300kHz 
in steps of 0.073Hz. 


References 


[1] Arizona Microchip website for PIC data sheets and development soft- 
ware: www.microchip.com. 

[2] MeLabs website for EPIC programmer details and software: 
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website: www.atmel.com/atmel/products/prod23.htm. 
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Simple projects using the PIC 


Complete software listings are not given for these designs as many of 

them are quite long and include subroutines and functions common to 
other projects in this book. The complete software can be obtained from 
the RSGB website. Several of the projects in this chapter were designed 
during the early days of their respective authors’ introduction to PIC pro- 
gramming so the code is often non-optimum and rather inelegant by mod- 
ern standards, another reason for not giving the full printed listings! 


iT n this chapter we show some standalone projects using PIC devices. 


The GOIAY programmable beacon keyer 


This keyer is designed to repeatedly send a pre-programmed message at 
regular intervals for identifying a beacon or repeater, for testing purposes, 
or for calling CQ in contests etc. A range of delays may be programmed 
between the CW message intervals, and as well as the normal keyer line a 
transmit/receive switching function is made available so the unit can take 
over full control of a transceiver for transmit/receive tests and CQ calls. As 
an additional luxury, CW speed can be changed during the transmission 
cycle by stored commands — allowing for example a callsign to be sent at a 
slow speed for identification, followed by locator information etc at a higher 
speed. 

Unlike other beacon keyer designs published over the years, this unit can 
be reprogrammed without having to remove the controller chip, merely by 
connecting it to a PC running a terminal programme such as Hyperlink 
over an RS232 interface. The CW message is stored in the non-volatile 
EEPROM storage available in the 16C84, 16F84 and later devices. 

The circuit is given in Fig 5.1 — the design is not much more complicated 
than that of the bare minimum PIC chip itself with two transistors to inter- 
face to standard keying and transmit/receive control circuits. A PCB layout 
making use of surface mount components to produce a postage stamp-sized 
module is shown in the photograph in Fig 5.2. The listing KEYER2.ASM is 
an example of the inelegant first programmes we often write until program- 
ming experience grows. However, it does work and so has been included in 
its original form; much ‘cleaner’ CW generation and RS232 routines are 
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RS232 to terminal 


described elsewhere in this book. The commands needed 


to programme the keyer message over the RS232 inter- 
face are shown in Table 5.1. 


SWR meter display 


In this project, the two voltage levels generated by aSWR 
meter head, corresponding to forward and reverse power, 
are measured by the A/D converter inside a*PIC 16C71, 
then used to generate an automatic, power-independent, 
SWR reading on an analogue meter. No adjustment is 
needed as power level is changed as the correction for 
forward power reading is calculated automatically. In ad- 
dition, a bar graph is presented showing actual forward 
power. There are plenty of suitable RF head designs for 
SWR measurement on all the amateur bands available so 
none will be reiterated here. Whatever RF head is adopted, 
it should be designed to give a voltage output of no more 
Top: Fig 5.1. The that 5V when the maximum power is being measured. An equal level for 
GOIAY beaconkeyer forward and reverse voltages is assumed, ie the head unit is properly sym- 
circuit diagram E : mas ; 
metrical. The unit can be battery operated and provision for automatic turn- 
Above: Fig 5.2.Pho- on is included, so the PIC and display circuitry are powered up by detect- 
tographofthekeyer . : : : 
moma _ inga level on Vfwd when a few watts of RF are applied. The unit automati- 
cally turns off after three minutes with no RF. No circuit details are given as 
constructors will probably want to choose their own way of implementing 
these functions. 
The 16C71 has up to four analogue inputs available — two of them are 
used here with the 5V Vcc supply being used as the A/D reference voltage. 
The main loop of the programme measures Vfwd and Vrev to eight-bit 
accuracy, then calculates the ratio Vrev/Vfwd which is needed to give a 
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Table 5.1. Programming instructions for the IAY Beacon Keyer module 


: Set the terminal programme (Hyperlink, Procomm etc) to 1200 baud, no parity, 8 bits, 
| 1 stop bit, no handshaking. If the interface is connected when power is first applied, the 
| keyer will go into command mode, where messages can be displayed and entered, and | 
| WPM and keying polarity can be set. Valid commands are: 
V_ Display software version. 
S Gointo beacon mode (if this command is executed, then the keyer will need to be 
| powered down to re-enter command mode). 
Display keying polarity and WPM flags. 
Set keying polarity and WPM flags. ’ 


Notes: Keying polarity can be — or + 
— denotes transistor on = keyed (ie key line grounded = keyed) 
+ denotes transistor off = keyed (ie key line floating = keyed) 


WPM is set by typing in a letter: 
A=5WPM B= 8WPM C=10WPM D=12WPM 
E=15WPM F=18WPM G=21WPM H=25WPM 
Display message in EEPROM. 
E Enter new message. 
Notes: Just type in the message. Procedural characters are coded as follows: 
E-CF 
]-VA 
There are several commands that can be embedded into the message. They are all 


entered in the form <command> and each use one character of message storage. 
Messages can be up to 63 characters long. 

<R> ~~ - Return to Start of message with no delay. 

<Wn> - Set WPM to n (nis a letter, as listed above) 
This command overrules whatever is set in the flags, so if Keying speed is changed 
during a message, it will remain at that value until changed back. 


<Dxyz> — Delay mode. 
x denotes transmit (T) or receive (R) 
y denotes key down (D) or key up (U) 


Z is delay: 
A=15seconds B=30 seconds C= 45 seconds 
D=1 minute E= 1.5 minutes F = 2 minutes 


G = 4 minutes 
Examples: 
<DTDF> - Transmit with key down for 2 minutes. 
<DRUB> - Receive with key up for 30 seconds. 


If the keyer has been connected to allow control of transmit, it can be programmed 
to do automatic CQ calls with periods of receive in between calls. 
It is advisable to always put an <R> at the end of the message, as the software does 
not do this automatically. The only exception to this is if the message is 63 
characters long, where the message will automatically repeat. Message input can 
be ended by pressing Return. 
A typical message would be: 
GB3SCX <WE>GB3SCX IO80UU59 <DTDA<R> 
This sends the beacon callsign once at 10 WPM, then again at 15 WPM followed 
by the locator, also at the faster speed. Then follows a delay of 15 seconds of plain 
carrier in transmit mode with the key down, after which the sequence repeats. 
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Table 5.2. Division routine used within the automatic SWR bridge software 


: cirf VREVLO ;Promote Vrev to 16 bit and divide by vfwd 

moviw  OxFF ;always at least one incr so start with -1 

movwf SWR ;also sets default for overflow as $FF 

movf VFWD ,w ; 

subwf — VREV,w -First check for VREV - VFWD (= Ww) 

DETSC ME STATUS 2 C ;if positive (C=1) then overflow will occur 
goto Getout ;leave SWR at FF to give maximum 

btfise | SuATUS | 4Z ;same applies for zero (equal) 


goto Getout 


} 

} 

: DivLoop 2 

incf SWR ;First pass sets it to zero if FF 

movft VFWD , w 

: subwf = VREVLO ;VREVLO = VREVLO - VFWD 

| btfsc STATUS 2G ;C = 0 if borrowed, ie -ve 

goto DivLoop 

movlw 1 

subwf  VREV ;can’t use decf as we need C bit set 
btfsc... STATUS ,, C 
goto DivLoop ;if clear, now -ve so finished division 


Getout 
power-level-independent measurement of the SWR. Division is one of the 
more complex mathematical routines to implement on any digital platform, 
and here a crude division routine operates as follows. 

First Vrev is compared with Vfwd to see if it is higher — it should never 
be the case, but an unbalanced RF head may give the erronéous result at 
high SWR levels; SWR is defined as maximum in this case and no calcula- 
tion performed. The case of zero Vrev, corresponding to 1:1 SWR, is also 
trapped to prevent a divide-by-zero problem. If the two voltage measure- 
ments give valid numbers, the eight-bit value for Vrev is expanded to 16 
bits by appending a low-order byte consisting of all zeros, then the eight-bit 
value for Vfwd is repeatedly subtracted from this 16-bit number until the 
result of the subtraction is negative. Each subtraction increments a counter 
(the SWR variable) so that when the result goes negative, this value con- 
tains the eight-bit result of the integer division Vrev/Vfwd. Table 5.2 gives 
a listing of the code included within the division routine. 

The output to drive an analogue meter to show the SWR is generated by 
pulse width modulation. Inside a loop the SWR variable generated from the 
division process is decremented by one for each pass. The output pin that 
drives the analogue meter is initially set to a ‘1’, but as soon as the SWR 
variable reaches zero this pin is set to a ‘0’. As the loop is always 256 clocks 
long the mean voltage on this pin after passing through a CR filter is 
proportional to the SWR value. A delay is built into the loop so that the SWR 
display is updated around 10 times per second. If it was set much faster than 
this, the extra unknown time taken for the division process — anything from 
0 to over 2000 clock cycles — could affect the PWM linearity. As it is, 
maximum error introduced gives around 10% longer cycle time at 
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maximum SWR and the direction of this error is such as to slightly compress 
the top end of the scale — not usually a problem as the SWR is usually too high 
to be useful at this point. 

Next, the forward voltage reading is used to drive the bargraph display 
on PORTB. A pseudo-logarithmic scale is employed here to make the 
bargraph display more useful and is generated by taking the three most 
significant bits of the reading only, then lighting, successively, from zero to 
eight LEDs in the bargraph depending on the value in these MSBs. 

The complete software listing is entitled ‘SWRBR3.ASM’ and can be 
obtained from the RSGB website. 


Frequency measurement 


The 16F84, along with most other PICs, includes at least one counter timer 
within the range of peripheral functions, usually with an associated prescaler 
which divides the input signal by one of several programmable values. This 
can be driven from either the internal clock oscillator, or from an external 
signal connected to one of the pins designated for this function; on the 
16F84 this is Pin 3, corresponding to input A4. The prescaler is designed to 
be clocked at a much higher frequency than that at which the rest of the 
circuitry operates, with operation at 30-40MHz possible. A frequency coun- 
ter function can be generated by enabling and disabling the counter in a 
controlled way using timing derived from the processor clock while it is 
counting this external signal. 

Apart from displaying the frequency as in a conventional frequency me- 
ter, simple straightforward frequency measurement opens up all sorts of 
possibilities for add-on accessories and automation in the areas of HF trans- 
mitting, such as automatic antenna selection based on measured frequency, 
and selection of filters and PA stages. 

The simplest way of using the counter is illustrated in the part listing shown 
in Table 5.3 which gives the set-up data needed to operate the counter timer 
with an external input and a subroutine which generates a value in the 
variable W register that is proportional to the frequency being measured. 
The resolution of the counter depends on the gate timing interval, defined 
by the loop around the label GateLoop, the value of the constant GateConst, 
the processor clock value, and the prescaler setting. 

In the listing shown, the prescaler is set to divide by eight, the delay loop 
generates a delay of 5.N+ 5 clock cycles so, with a value of 99 for the constant 
and a 1MHz clock from a 4MHz crystal, the gating, or timing, interval is 
500ps, measuring the frequency input divided by 16. The resulting fre- 
quency is therefore measured to a resolution of 16kHz with a maximum 
upper frequency limit of 4.08kHz dictated by the eight-bit count limit on the 
timer. 

The counter resolution can be extended by making use of the counter 
overflow bit 2 in the INTCON register. Every time the counter overflows 
from 255 back to a count of 0, this bit is set. An interrupt can be generated, 
or the bit can be read by polling, then, by incrementing a software counter 
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Table 5.3. Setting up and using the counter/timer function for frequency measurement 


;Setup needed to initialise timer. 
bsf STATUS, RPO ;ram page 1 
movilw  b'11100010' ;External input, Prescalar /8 
movwf OPTION_REG 
mov lw b'00010000" ; 


movwf  TRISA ;A4 as input for Fin, rest as outputs 
bcf STATUS, RPO ;ram page 0 
GateConst equ d'99' ;Depends on clock frequency, prescale etc. 


;Frequency measurement routine 


decfsz DelReg 

goto GateLoop 

movf TMRO , Ww ;Read the counter at precise timed instant 
return ; Frequency measurement returned in W 


GetFreq 
clint TMRO -  s;Initialise the timer 
moviw GateConst ;This constant determines how long the count 
movwf DelReg ; gate is opened for. 
nop 
nop : 
nop . 
GateLoop ;delay between TMR set and read = 5N+5, so a value sd 
nop ; of d'99' gives 500us assuming a 4MHz xtal. with 
nop ; /8 prescale, Temp contains multiples of 16kHz 
| 
| 
/ 


each time, a frequency counter of arbitrary length can be generated. Witha 
suitable gating time, higher-resolution measurement is possiblé. 

Using the prescaler in this way limits the measurement accuracy possible 
as the inherent accuracy of + one count applies to the divided-down wave- 
form. Therefore for high-division ratios, accuracy is limited to a count of + 
prescaler division ratio. 

Peter Rhodes, G3XJP, has written a number of programmes for the PIC 
that use a more precise method of frequency measurement, where opti- 
mum resolution is gained by clocking out the residual count left in the 
prescaler after each increment of the counter register [1, 2]. 


Waveform generation 


Sometimes a PIC can be a simple solution for an application where the use 
of a processor would not normally be considered. An example of this is 
waveform generation. By the addition of a D/A converter, a sampled wave- 
form of any arbitrary shape can be formed by generating, or looking up, 
successive values and sending these to the D/A converter. A normal D/A 
converter may not even be necessary as illustrated in the sine-wave genera- 
tor circuit of Fig 5.3. This particular function simulates a sine wave by gen- 
erating the software equivalent of a shift register in a loop, with feedback 
from the final stage to the first stage passing though an inverter. The con- 
cept is covered in more detail in reference [3]. 
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Synthesising waveforms 
The weighted resistors are 
chosen so that, as the ‘1’s or 
‘0’s progressively build up 
from left to right, a stepped 
approximation to a sine wave 
is generated. With an eight- 
bit shift register clocked at 16 | Cock in 
times the wanted frequency | >2V p-p 
output, a 16-step approxima- 
tion to the required waveform 
results, and theory predicts 
that, apart from the funda- 
mental, the only spurious 
products will be at 15.F, 17.F; 
31.F, 33.F and so on, at levels 
of 1/15, 1/17, 1/31 of that of 
the fundamental. A simple filter is all that is then needed to clean up the 
output, resulting in a stable and clean sine wave. Other waveforms can be 
generated by choosing appropriate resistor values to give the required in- 
crease/decrease in amplitude for each step. 

The PIC source code shown in Table 5.4, when used with the circuit of 
Fig 5.3, takes this waveform generator a stage further, producing a binary 
phase shift modulated carrier of 1.6kHz, modulated with a 255-bit pseudo- 
random sequence at 400 bits/second. While of limited use as it stands (the 
pseudo-noise waveform was used to evaluate a microwave data communi- 
cations link), the listing illustrates how modulated waveforms can be easily 
generated. 


Interrupt-generated timing 
Here a timer-generated interrupt is used to define the precise timing inter- 
val, relieving the programmer from the tedious job of carefully adjusting 
clock cycle delays to achieve the correct result. Instead, the timer counter 
module generates a count which is derived by dividing down the processor 
clock by a prescaling factor, here four times. Every time the timer/counter 
overflows, an interrupt is generated which sends the software to the inter- 
rupt vector at programme address (04 — given the label ints in Table 5.4. 
The following method is used to adjust the interrupt frequency to the 
wanted values. At the start of the interrupt code the timer is preloaded with 
a value of 233 so that it only has to count from this value up to 256 before 
overflowing, a count of 23. The number is calculated by noting that the 
interrupt always takes several clock cycles to process (here seven clocks) so 
by the addition of an extra NOP statement the overhead consumes eight 
clock cycles. As the timer operates on the clock frequency divided by four, 
these eight cycles equate to two counts of the timer, hence the count of 23 
before the interrupt is generated gives an effective division by 25. The in- 
terrupt frequency is calculated by dividing the processor clock frequency 


Audio 
waveform 
output 


Fig 5.3. Sine-wave 
generator circuit 
diagram 
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Table 5.4. Complete listing of BPSK pseudo-random sequence generator 


_ ;PRNGENO2.ASM 
;Generates 1.6kHz sinewave, BPSK modulated with PR sequence. 10.24MHz Xtal, 
;2.56MHz clock, prescale /4, timer counts 25 cycles for 25.6kHz interrupt 


LIST P=16F84 


INCLUDE “P16F84.INC" 
cblock Ox0D 


Counterl ;Times data clock from interrupt 
SineData ;Makes up synth sinewave, BPSKed for PORTB 
SR1 ;Shift register 
SR2 
Temp 
FB ;Contains Feedback for PN generator 
endc 
#define Tapl SRI 00 ;Feedback taps for PR sequence 
#define Tap2 SRiv wwe 
#define Tap3 SRE as 
#define Tap4 SRV, 5 
__config Ox3FF1 


;code starts here 


org 0 
nop 
movlw  b'Q0000000' ;No interupts until passed thro here once 
movwf  INTCON : rt 
goto startup ;jump to main code 
ints ;Here 4 cycles after timer overflow 
bcf INTCON , TOIF ; every 100 clocks = 25.6kHz sampling rate 
nop ;Needed to make up 8 clock cycles total 
mov lw a 2337 *=N-2'. Timer counts: 25 of Cec /°4) 
movwf  TMRO ;Timer restarts counting 2 cycles after here. 


;To here takes 8 clocks (with the single NOP) 
3N = 256 - Count + 8/P 
;Below here not time critical, but must be less than than 95 cycles total 


movf “SineData , W ;Output the sample first, so there is no 
movwf  PORTB ; jitter on the waveform 


;Generate 1.6kHz sinewave using 8 bit reg with weighted resistors 


crf SineData , W ;LSB into carry, but preserve SineData 
rif Temp ;Carry into Temp,0 

comf Temp ;Toggle LSB = FB. 

(ol ak Temp ;FB into Carry 

ref SineData ;do the shift, Feedback into MSB 


;Test for Clock change 
incf counterl ;Count 64 = 0x40 for 400b/s 
mov lw 0x40 
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Table 5.4 (continued) pe 


subwf  Counterl , W ;Test for count / 
btfss STATUS; Z 
goto NoClock 


clr Counterl1 313 clocks to here 

moviw 0 : 
| btfsc Tapl 
KOR TW 71 ;Toggle w=0/1 if FB bit is al 
btfsc Tap2 
xorlw 1 
} btfsc Tap3 
xorlw 1 
btfsc Tap4 
xorlw 1 ;wW contains data to be shifted into SR MSB 
i movwf Temp ;Put it into Temp,0 
ref Temp ;and into C 
ref Shia ;then do the shift, with C into MsB of SR 
; 
| DEtSE-- SRL", 0 ;Use LSB of SR as data 
| comf SineData ;Differential modulation, change if -ve 
NoClock 
retfie 
ge eet 
| startup 
| clrwdt 
i bsf STATUS, RPO ;ram page 1 
movlw  b'11000001' ;Internal input, Prescalar /4 no pull-ups 
movwf  OPTION_REG 
i mov lw b'00000000' . 
movwf PORTA : 
movlw  b'00000000' ;All outputs for testing 
: movwf  PORTB : 
bcf STATUS, RPO ;ram page 0 
mov Iw b'10100000' ;Generate overflow on TMRO Overflow (TOIE) 
I movwf INTCON : 
i clrf — PORTB 
elrf PORTA 
clrf Counterl 
clrf SineData 
i movlw  OXFF 
movwf SR1 
: movwf  SR2 
| SitAndwait | 
goto SitAndwait ;Sit in this loop while waiting for interrupt 
aires renee | 
end 
I 


by the prescale factor and this interrupt-generated value, ie 100. With a 
crystal of 10.24MHz, the processor runs at a quarter of this, ie 2.56MHz, so 
the interrupt occurs at a frequency of 25.6kHz. 

Most of the active code is within the interrupt service, with the main loop 
just a place for the processor to sit and wait for the next interrupt interval. 
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Within the interrupt routine a simulated 
shift register with feedback, using the vari- 
able SineData, first generates the audio 


Data clock in 


Clock = 8 frequency of 1.6kHz , whose final fre- 

SER In parallel out quency is equal to the interrupt frequency 
ree eee | RE tail gs) divided by 16. The next part of the code 
uses the Counter! variable to count every 

a55- bilosetides 64 interrupts, giving a data clock fre- 


random sequence | quency of 400Hz (25.6kHz/64) which 
then passes though to the pseudo-random 
sequence generator routine. The 255-bit 
long PRS is generated by simulating the 
classic shift register with feedback via ex- 
clusive-OR gates connected to appropri- 
Fig 5.4. Psuedo- ate taps as shown in Fig 5.4. Depending on the output of the PRS at each 
random sequence —_4()()Hz interval, the sine wave is inverted, resulting in a 1.6kHz tone, differ- 
generator ‘ ; ; 
entially phase shift keyed at 400 bits/second. 

As the interrupt occurs every 100 clock cycles and there are always sev- 
eral ‘hidden’ clock cycles required to process the interrupt, the service rou- 
tine must be short enough to complete before the next interrupt would be 
generated. If the processor has not seen a Return from Interrupt (RETFIE) 
command at that point the new interrupt will be delayed until it has re- 
turned, upsetting the timing interval. Comments in the listing show where 
code within the interrupt is time critical, and vigilance has to be constantly 
maintained when writing such code when using interrupt-generated timing 
so that the time taken to service the interrupt is always less th@n that of the 
interrupt frequency. 

Having said that, the timer-generated interrupt is one of the easiest ways 
to produce accurate timing on a PIC without the complexity of defining 
exact clock cycle counts. 


Data logging 


In the last chapter we looked at an A/D converter with a serial interface 
used for sampling an audio waveform. For monitoring of voltages that change 
slowly, over minutes or days, this is not the best solution to follow as the PC 
logging software has to cope with the huge flow of data coming in. Most of 
this has to be rejected and custom logging software is going to be required. 
So why not make use of the PIC to generate a suitable logging interval, then 
format the data sent along the RS232 interface? 

We can then take the opportunity to make the data format more palat- 
able to standard utility software that can directly read from the serial inter- 
face and save to disc for subsequent analysis. 

The interrupt-generated timing technique in the last section can be ex- 
tended, by suitable choice of counter length, to generate timing intervals 
from seconds to years. Additionally, the binary data as generated by the 
A/D converter can be converted to standard ASCII text so that it can be 
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directly read by the PC and saved directly to disc or displayed on a screen. 
In either case Hypertrm or Procomm, the ubiquitous serial port software, 
can be used to read the incoming formatted data directly. 

As a final twist, why send the data on the RS232 interface at all? Large 
memory chips are available these days, and many have serial interfaces 
that can be connected to the PIC with two or three wires. In the case of a 
logger that may only be called upon to generate a few kilobytes of data, the 
latter could all be dumped into the local memory, and this could be subse- 
quently uploaded to a PC. 

With CMOS technology throughout, the entire data logger need only 
consume an average of a few microamps (especially if the processor is 
clocked at 32kHz) so it could be left monitoring data in a remote location 
for many months running off a single battery. Component supplier’s cata- 
logues list many examples of suitable memory devices. 

The extra routines needed to add some of these functions to the serial 
D/A interface of Fig 4.5 are given in Table 5.5. A single-chip, multi-pur- 
pose data logger, the HF-08, is based around the 16C710 PIC, a lower-cost 
alternative to the 16C71, and allows a number of sampling functions to be 
selected by connecting links on the module or by software commands. Sam- 
pling and data formats possible are: 


* Eight-bit binary data sampled at 100ps, 140ps and 250ns. 

* I/Q sampling of a 1kHz tone at 1000 samples per second. 

* Sampling at 0.2, 1, 5, 10, 60 and 300s intervals with eight-bit binary 
output. 

* Sampling as above but with ASCII text output for direct computer log- 
ging. 

The circuit for the HF-08 data logger is shown in Fig 5.5, and a compact 

layout designed to fit inside a dual nine-way D-type connector adapter 


package as shown in Fig 5.6. Software for the HF-08 can be obtained from 
the RSGB website as LOGGER.ASM. 


The HF-08 data logger 


This section is taken from the HF-08 operating manual. 

The HF-08 data logger is a small eight-bit analogue-to-digital converter 
module for digitising an analogue signal and sending the data to the serial 
(COM) port of a personal computer or similar. 

There is sufficient flexibility built into the design of the module to allow 
numerous different types of data logging when used with the appropriate 
software. The analogue input can be link selected for a range of input voltages 
and, with the addition of one or two external components, this can be ex- 
tended still further. 

The data output from the module is sent in RS232 format at a fixed rate 
of 115200 baud (bits/second). Data format is eight-bit data, one stop bit, no 
parity. The module is self-powered from the RS232 port using the addi- 
tional handshaking lines RTS and DTR. Voltage levels on the data output 
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Table 5.5. Routines needed to add more useful data logging functions to the serial port A/D 


converter of Fig 4.5 


;Set up timer interrupt 


bsf STATUS , RPO 

moviw  b‘00000100' ;Internal input, Prescalar /32 enable pull-ups 
movwf OPTION_REG ~ 

bcf STATUS , RPO 

movlw  b'10100000' 

movwf  INTCON ;Enable Timer Interrupt, disable PORTB change 
cline Counterl 

alae Counter2 


;Interrupt service routine to read A/D converter at required time intervals. An 8ms 
3 timer overflow interrupt is set using internal 1IMHz clock with /32 prescalar 
; and preseting for a count of 250 before overflow. 


btfsc INTCON , TOIF ;test for timer overflow 


goto ClockTick ;Can only happen in slow modes 
retfie ;default for any other interrupt 

ClockTick 
nop 
nop ;Here 13 cycles after timer overflow NOW IN INTERRUPT SERVICE 
mov lw 2 
call Delay ;(15) need 32 cycles INT > MOVWF TMRO 
nop 
bcf INTCON , TOIF s;every 8ms a 
nop ; 
moviw 7 ;Timer counts 249 of (Fc / 32), + 32 residual clocks above 
movwf  TMRO ;Timer restarts counting 2 cycles after here 

;-—— Below here is not time critical but must complete in 8ms - 

incf Counterl1 ;Count 8ms units for wanted delay 
btfsc STATUSE se Z 
incf Counter2 316 bit count = max 524 seconds 
movf TickCount2 , W ;Value of TickCount1/2 determines total delay 
subwf Counter2 , W ;Test for MS Count 
btfss STATUS aeez 
goto DoneTick ;Exit if not MSB count limit 
movf Tickcountl , w 
subwf  Counterl , w ;Now test for LS count 
btfss STATUS ie Z 
goto DoneTick ;exit if not LSB count limit 
clIrf Counterl ;Here every timed interval 
Chet Counter2 ;Reset counter 
bsf ADCONO , GO ;Hit A/D converter 
movlw d'19 
call Delay ;Wait 100us for conversion to complete 
movf ADRES , W) ; A/D reading in w | ready for further processing 
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Table 5.5 (continued) 


retfie 


;Binary to Text conversion 


} 

| 

| SendText ;Convert 8 bit binary value to ASCII text in range 000 to 255 

| movwf Temp ;Save binary value 
i CURE $3 ;Hundreds i 
cIrf s2 ;Tens 
Cire Sl ;Units 

| HunLoop 

| incf S3 ;1 to 10 counts 

movlw  d'‘100' 

subwf Temp ;Temp = Temp - 100 

btTse.) VSTATUS{ 3" G ;1 if +ve after subtraction 

goto HunLoop ;Repeatedly subtract 100 until -ve 

- decf S3 ;adjust to 0-9 

moviw d'48' ;Adjust to ASCII 

addwf = $3 

moviw  d'‘'100' 

addwf Temp ;restore final decrememt so Temp is in range 0-99 

| TenLoop 

incf S2 ;1 to 10 counts 

movlw - d‘10' 

subwf Temp 

btfsc STATUS, 5 .€ ;1 if +ve after subtraction 

goto TenLoop ;Repeatedly subtract 10 until -ve 

| decf S2 ;adjust to 0-9 

movlw  d'48' ;Adjust to ASCII 

addwf S82 

moviw  d'‘10' 


addwf Temp ;restore final decrememt so Temp is in range 0-9 


j 

| movf Temp , W 

movwf = S1 

i movlw d'48' ;Adjust to ASCII 
addwf sl 


movf S35 W 

call send232 

movlw  d'‘'20' 
call Delay 


movf S2 oo W 
call Send232 
movilw  d'20' 
i call Delay 


movf Siew 
call Send232 
moviw  d'20' 
call Delay 
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Table 5.5 (continued) 


moviw  d'‘13' ;Final carriage return 
call Send232 


retfie 
Delay :general purpose delay routine needed in int service and other places 
movwf DelCount ;Enter with N in W register 
deloop 
nop ;Total delay = 5.N + 3 (+ 2 to call = 5.N + 5) 
nop 
decfsz DelCount 
goto deloop 
nop 
return 


100k 
AC In 


-ve In 


100k 
Ref Out 


(1, 2, 5) A Sees POE 2N7000 


Fig 5.5. HF-08 data do not follow the full RS232 convention of plus and minus levels; instead, 

saan circuit dia- the voltage swing is from 0 to +(5-10)V. This is permissible, as all modern 
RS232 receiver chips actually detect at a threshold of around 1V positive, 
allowing ‘unofficial’ compatibility with other 0-5V signalling standards. 


Connections 


The serial data output comes from a nine-way D-type female connector, 
intended for direct attachment to a PC serial port. A short length of cable 
up to around 2m may be used here but the driver circuitry is not designed 
for runs longer than this. 


94 


CHAPTER 5: SIMPLE PROJECTS USING THE PIC 


Setting the analogue 
Input range 

The analogue input is applied 
to the nine-way D-type male 
connector. Connection to 
various points in the input 
buffer amplifier are available 
on this connector plus a buff- 
ered version of the internal 
2.5V reference. 

By linking pins appropri- 
ately, the input measurement 
ranges shown in Table 5.6 are 
available. 

These may be further ex- 


tended by the use of external resistors. Refer to Fig 5.5 for the input buffer Fig 5.6. The HF-08 


circuit. data logger 
Sampling modes 
Three types of operation are available with the HF-08: 


1. Fast sampling for audio or rapidly changing signals. Three sampling rates 
are available : 


10000Hz = 100p1s sampling interval 
7142Hz 140ps sampling interval 
2500Hz 400ps sampling interval 


Output data format is limited to one eight-bit binary data word per sam- 
ple. Software commands, eg to change rate, may be sent in real time 
while in this mode. 


2. Complex sampling for vectorscope or similar purposes. A signal of 750- 
1250Hz, centred on 1000Hz, is down-converted to zero frequency and 
complex in-phase and quadrature components are outputted. Software 
commands will be accepted while in this mode. 


3. Slow sampling modes for longer-term data monitoring. Six sampling rates 
are available : 


Table 5.6 


0 to 1.25V 


8 2 (OV) E39 10.5: Very high 
/ Oto 2.5V 8 2 (OV) Very high 
0 to 2.5V 8 9 7to1 ~ 200kQ (pin 8) 
(differential) 100kQ (pin 9) 
| Oto 5V 8 2 (OV) 7to1 200kQ 
—2:5V to 2.5V. 8 2 (OV) 7 to3 200kQ (to Vref) 
—2.5V to OV 8 2 (OV) 9to5 7to3 200kQ (to Vref) 
6 


| £2.5V AC 2 (OV) 7 to 3 100kQ in series with 1 pF 


jnanisontamisssntnonsouhnasoiostsovsasomnasiantnnisnasnsmacasdemnstaat-nsaeniisneneeteiushscvarusrsnesicansansersvivewwusioninetneosinal 
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0.2s interval 

Is 

5s 

10s 

Imin 

Smin 
Data is transmitted in real time immediately after the measurement sam- 
ple is taken. Output format can be selected either as an eight-bit binary 
word, same as the fast sampling rates, or BCD text format consisting of 
three ASCII digits for hundreds, tens and units of the binary value from 
0-255, followed by a carriage return (ASCII 13). This latter option is 
designed for direct logging to a file using, for example, a terminal pro- 
gramme such as HyperTrm or Procomm. 

No commands sent on the RS232 link will be accepted while slow sam- 

pling is underway. 


Control of operating mode 
The operating mode of the device may be set by two means: 


Software control 
When in fast sampling mode, the ASCII command Sn will software select a 
sampling rate from Table 5.7. 

Other ASCII commands accepted while in fast sampling mode: 


ay Set text mode for slow rates 
B Set binary mode for slow rates * 
bs Lockout (inhibit any more serial commands) 


All software commands consist of just one or two characters; no carriage 
return is necessary. Upper case should be used for all commands. Once a 
slow mode has been selected, no further software commands will be ac- 
cepted, so the T or B command needs to be sent before the Sn one when 
selecting one of these. 

For example, T S 6 will set sampling at every five seconds with output 
data sent in text format (number 0-255 followed by carriage return). S 2 L 
will set 2500Hz sampling and lock out any further serial commands. 


Link selection 
As an alternative, up to four wire links may be added to set the operating 
mode that is selected when power is applied. In Table 5.8, a ‘1’ means a link 
is fitted, a ‘0’ indicates the link is absent. 

Serial commands will be accepted while any of the first four sampling 
rates are selected. 


Operation 

The unit is connected to a spare COM port. If any of the supplied software 
is used for data logging follow the start-up instructions for the appropriate 
programme for selecting COM port, sampling rate etc. 


CHAPTER 5: SIMPLE PROJECTS USING THE PIC 


At start-up, the links are read and data output starts immediately at the 
appropriate sampling rate. 

For logging of text mode results a serial terminal programme such as 
Hypertrm (supplied with Windows) or earlier DOS-based software such as 
Procomm may be used. The following procedure makes operation of the 
module straightforward. 

Set up the terminal programme for the appropriate port, 115200 baud, 
no parity, eight bits and one stop bit, ie 115200 N 8 1. All flow control must 
be OFF. Incoming <CR> translation to <CR LF> should be set to ON. All 
these settings can be found in the Hypertrm Properties menu; other serial 
driver programmes will provide similar functions. 

Hypertrm allows these settings to be written to a start-up name and an 
appropriate icon may be selected which makes subsequent start-up very 
straightforward. 

If no links are fitted, the screen will fill with meaningless characters - 
these are the binary results of the input data being sampled at 10000 sam- 
ples per second. Key in (for instance) “TS5’ and the display will change to 
three-digit numbers being produced every second at one per line. 

If writing your own software, the following points need to be borne in 
mind. 

Module power is obtained from the RTS and DTR lines and at least one 
of these, preferably both, needs to be active (high). Flow control is not avail- 
able, but if necessary data can be started and stopped by powering down 
the module by removing RTS and DTR. Mode configuration commands 
will need to be resent each time the module is powered up unless link selec- 
tion is in use. 

Precautions need to be taken against serial buffer overflow situations aris- 
ing, as data starts to be transmitted immediately after powering up. 

Some laptop computers may not provide a ‘strong’ enough output from 
the RTS and DTR port to allow the module to generate the necessary regu- 
lated voltage internally. In this event, a separate battery of anything be- 
tween 7 to 20V may be connected between pin 4 (positive) and pins 1, 2, 5 
(ground). Current consumption is approximately 6mA. 

All analogue input pins are protected against reasonable overload: inter- 
nal voltage swing is clipped to the internal supply voltage and current is 
limited by 100kQ resistors; maximum safe overload voltage is limited by 
power dissipation in these resistors to 100V DC or RMS. The 2.5V refer- 
ence output on pin 3 comes from an internal op-amp buffer and is pro- 
tected against a short-circuit to ground by the inherent current limit pro- 
vided by the power available from the COM port. Protection against con- 
nection of this to any external voltage sources is not provided. 

To maximise operating speed, no decoupling of the analogue inputs has 
been provided. In noisy environments, or when sampling slowly changing 
signals, consideration should be given to the addition of decoupling or fil- 
tering capacitors. 

When used with fast-changing signals, for example audio, no anti-aliasing 
filter is provided, and signals greater than one half the sampling rate will 
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give erroneous results as products will be aliased. Sampling rates 1-3 have 
been selected as follows: 


° 7142Hz (1/140ps exactly) allows the output of an SSB receiver limited to 
300-3300 Hz to be optimally sampled. 

* 2500Hz allows a communications receiver using CW mode with a nar- 
row filter and BFO tone up to 90 Hz to be optimally sampled. 

¢ 1000Hz I/Q sampling allows the special case of the phase of a tone cen- 
tred on 1kHz to be detected directly. Inside the HF08, the incoming 
signal is effectively down-converted, or mixed, with sin and cos compo- 
nents of a local oscillator at 1kHz. The lack of anti-aliasing filtering and 
the method of conversion means that the input signal must be pre-fil- 
tered to the range 750-1250Hz. This is conveniently done by using a 
CW filter in a communications receiver and setting the BFO note to 
1kHz or tuning for a 1kHz output frequency. 


Data output is in the following form, and consists of four bytes per sample 
containing 10-bit I/Q data in two’s complement format: 


¢ Byte 1, [hi, two high-order bits of the I channel (cosine) data in the form 
000000xx. 

* Byte 2, Ilo, lowest eight bits of I channel data. 

¢ Byte 3, Qhi, two high-order bits of the Q channel (sine) data in the form 
110000xx. 

* Byte 4, Qlo, lowest eight bits of Q channel data. 


The two high-order bits of Ihi and Qhi are coded as shown to permit cor- 
rect identification and synchronisation should data slippage occur. Ideally, 
every four-byte frame of data will be checked for correct alignment before 
use is made of it. 

Full I/Q data can be reconstructed (using ‘C’ notation) from: 


I = ((Ihi & 0x03) << 6)/64 + Ilo 
~Q= ((Qhi & 0x03) << 6)/64 + Qlo 


This will correctly align and sign extend the data to give 16-bit signed inte- 
gers. 


Phase = ATAN2 (I/Q) 
Mag = SORT (I*2 + Q”9) 
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Remote control and telemetry 


he areas of remote control and telemetry offer all sorts of possibili- 
ties to the radio amateur for using microcontrollers, and illustrate 
many of the hardware and software techniques applicable to other 
fields. Remote control is often used with repeaters and beacons operated 
on remote sites, and for this application various security measures have to 
be applied to ensure valid commands are issued and to prevent unauthor- 
ised users or ‘hackers’ from attacking the remote facility. Telemetry, or 
remote metering, is invaluable to permit parameters such as equipment 
status, supply voltage, cabin temperature, power output level or even door 
open/closed status to be monitored without having to make a site visit. 

A range of PIC-based hardware designs is included here for these vari- 
ous functions but, more significantly, a library of PIC assembly code rou- 
tines is developed, along with various algorithms where necessary, which 
can be transplanted and modified at will for any future project. This section 
also illustrates how PIC input and output functions can be expanded with 
additional hardware, such as shift registers to increase the number of I/O 
lines, higher-resolution A/D converters with more analogue ports, and ex- 
ternal decoder chips. 


Dual-tone multifrequency signalling 


The DTMF signalling scheme is now in worldwide use for telephone dial- 
ling. The digits from 0 to 9 plus two special characters, ‘*’ and ‘#’, are 
represented by two audio tones sent simultaneously — one tone is taken 
from a group of four corresponding to rows on a typical telephone keypad, 
the other one of three tones corresponds to the column. As an extension to 
the standard set, a fourth column and tone is allowed, permitting the letters 
‘A’ to ‘D’ to be encoded and giving 16 unique codes. The tone frequency 
pairing with associated digit coding is shown in Table 6.1. Note that the 
code output from the chip for the ‘0’ digit is actually the code for decimal 
‘10’ rather than zero. The zero code was originally adopted as an error 
condition and should never be generated from a valid tone pair but, when 
including the fourth column, this code now has to be allocated as a valid 
state in order to allow all 16 possible key combinations. 
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Table 6.1. DTMF digit/tone codin 
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With the widespread use made of DTMF coding, it is inevitable that a 
range of custom chips have become available to make use of this coding 
scheme. The decoding chips contain all the necessary filtering and decision 
circuitry, as well as detection and rejection of spurious/error tones. The 
final result is a very robust and error-free, albeit rather slow, digital coding 
scheme for voice-band channels which can be used on radio links just as 
easily as on telephone lines. One of these single-chip decoders that is straight- 
forward to use is the Mitel MT8870D integrated DTMF receiver chip. With 
a handful of external resistors and capacitors, an audio signal input can be 
turned into a four-bit code presented on four parallel wires, with a fifth 
carrying a strobe signal. Mitel (now Zarlink), also produces other devices 
for DTMF coding, such as integrated transceiver chips. For the full range 
see reference [1]. 


Telephone line remote controller 


The unit described is intended for remote control of beacons and repeaters 
where a permanent telephone line is available for secure control. The unit 
may be used with a duplex radio link, for example when controlling a re- 
peater, but for simplex (transmit/receive) operation, hardware and software 
changes will be required. Furthermore, issues such as security of control 
codes may inhibit use over a public radio channel. 

On ringing the telephone number of the line to which the controller is 
connected, it will automatically answer after approximately two rings. A 
personal identity number (PIN) is then entered, followed by a command 
using DTMF tones generated by the calling telephone to control the re- 
mote circuits and read their status. 

Direct connection to a telephone line requires that equipment be ap- 
proved for such connection, so no complete details can be given here for 
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such an interface. However, a suitable interface module for connection that 
may meet type-approval regulations is given at the end of the article. Some 
alternative means for making a safe connection to the Public Switched Tel- 
ephone Network are also suggested. In all cases the relevant approvals and 
specifications should be read and followed in construction. 


Control protocol 


Two levels of control are allowed. One set of PINs, intended for issuing to 
persons not holding an amateur radio licence, will turn OFF all controlled 
circuits with no ability to switch them back ON again using this number — 
the associated all-off commands are referred to as Priority Commands. An- 
other PIN gives access to individual ON/OFF control of the remote circuits 
and allows the status of these, and the controller itself, to be read back using 
CW messages. This is referred to as the User PIN. If a Priority Command 
has been issued, this is indicated in the status message. Remote power sup- 
ply monitoring is also featured, as the controller maintains a back-up bat- 
tery to store the controlled circuits’ state during power failures. If the bea- 
con or repeater goes off-air this message allows the operator to see if power 
failure is the case or whether a command or equipment failure has occurred. 
The internal battery should be able to power the PIC and DTMF decoder 
for one to two days. 


Design 

Fig 6.1 shows the circuit diagram of the controller but intentionally gives 
no details of interfacing to the telephone line - components within the box 
labelled ‘Line Interface’ are for illustration only. A dedicated MV8870 
DTMF decoder IC performs all the audio filtering, validation and data de- 
coding and sends a four-bit code representing the DTMF digit received, 
plus a strobe, to a PIC microcontroller. At all times the PIC is monitoring 
for valid DTMF codes, whether the interface is off-line or on-line. This 
allows for local on-hook signalling as well as non-phone line, or leased line 
use. The decoder chip requires a 3.58MHz clock generated by a crystal, 
and for convenience the same oscillator is also used to supply the PIC clock. 
The PINs are stored in the PIC’s non-volatile memory at the time the PIC 
is programmed, and every DTMF sequence received is checked for a valid 
PIN. Up to three circuits can be controlled from this design and, as shown, 
two command outputs are in the form of a switch closure to ground in- 
tended for operating relays or similar, and one is an uncommitted 0/5V 
logic level. 

The PIC generates audio CW messages used for acknowledging data 
entry and status messages. A LED is included to show locally when audio 
responses are being generated but is really there only as an aid during soft- 
ware development and is fully software programmable. 

The final task of the PIC is to respond to the telephone line and perform 
the auto-answer function. An opto-isolator in the line interface monitors 
the line for ringing voltage and, when this is present, C8 is charged. When 
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Line interface 


Fig 6.1. Telephone the switching threshold on the PIC’s A4 Schmitt trigger input is reached, 
line remote control 43 is activated which operates the relay or switch in the line interface via 
circuit ae ; . : 
Q1, seizing the line. C8 is then discharged, ready for the next call. To en- 
sure fail-safe operation, the PIC software maintains a continuous time-driven 
interrupt counter. When a particular value of count is reached (after 20 
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seconds) the controller will release the phone line irrespective of the state 
of any command entry. Every time a DIMF digit is received the counter is 
reset to zero, restarting the 20s time delay. This means that is impossible to 
lock up the controller in a state that keeps the phone line latched on, and to 
terminate a control session just hanging up or entering no tones for 20s is all 
that is needed. Immediately before going off-line, a tone is sent. 

The nominally 5V power supply for the MV8870 and the PIC is gener- 
ated by a NiMH battery which is float charged by a constant-current source 
of 10mA. With a PIC current consumption of 6mA this leaves 4mA to keep 
the battery topped up. Voltage input can be anything from 7 to 20V. 


Telephone line interfacing 


Telephone operators are very concerned that connections to their network 
cannot cause any harm to exchange signalling equipment, personnel or 
correct operation of the network. As part of European and world harmoni- 
sation, the requirement for individual approval of all such equipment is no 
longer needed (BABT approval) but design specifications and rules are in 
place which must be adhered to if direct connections are contemplated and 
approval by random selection of production items is considered satisfac- 
tory. Most of these are concerned with safety isolation, voltage breakdown 
and testing, but also such matters as audio drive levels and out-of-frequency 
band energy are specified. See reference [2] for more details. 

Fortunately, ready-made modules are now available to perform all the 
line interfacing and safety barrier functions. Using of one of these means 
that when coupled with correct construction techniques and housing, a de- 
sign can be made that is capable of meeting the regulations. No details will 
be given here as it is each builder’s own responsibility to ensure that his or 
her construction meets the requirements. Many of the data sheets and ap- 
plication notes for telephone line interfacing components give helpful in- 
formation on design and construction techniques — one of the most impor- 
tant is the need for at least 5mm creep distance over a PCB surface between 
any connection to the PSTN network and connections to the user’s side. 


Using the remote controller 

The remote control unit will auto-answer a telephone line and command 
three circuits on or off depending on DTMF codes sent to it. CW responses 
are generated showing the status of the controlled circuits. 

Separate PINs are needed to access the controller. Three PINs are used 
individually to turn OFF each of the three controlled circuits. These are 
intended for issuing to non-licence holders to allow them to turn off beacon 
or repeater equipment without their having the ability to switch the equip- 
ment back on again. Receipt of any of these three PINs sets status flags that 
can be read by the user. 


e PIN 1 turns OFF Circuit 1 
¢ PIN 2 turns OFF Circuit 2 
¢ PIN 3 turns OFF Circuit 2 
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¢ PIN 4 gives access to a command set which controls the individual ON/ 
OFF state of each command circuit and allows the controller’s status to 
be read back in the form of CW messages. This PIN is intended for the 
beacon/repeater keeper(s) use only. 


Operation 

After the controller’s telephone number is dialled, it will answer after ap- 
proximately two rings, and reply with a 1800Hz tone. At the end of this 
tone one of the PINs may be entered. Entering PIN 1—PIN 3 will immedi- 
ately turn off its associated controlled circuit and respond with a double 
bleep to show the command has executed. If this is not heard, repeat by 
entering the full PIN again. PIN 1, PIN 2 etc may be entered in any order, 
waiting for the double bleep each time before entering the next PIN. 

Alternatively, enter PIN 4 and after a short delay the controller will re- 
spond with a blip to say it is now waiting for a single command digit. If no 
blip is heard, re-enter the four-digit code. After hearing the response, enter 
a command from the list below and, depending on the command entered, 
the controller will respond with either a ‘K’ in Morse or the status messages 
followed by a ‘K’. Acknowledgement is sent even if invalid command digits 
are entered — these entries will be ignored. 

The command sequence can be repeated continuously, with PIN 4 + 
command entered each time. At any stage, if no response appears from a 
PIN or command entered, just repeat until accepted — problems can occur 
if tones are entered too quickly and before an acknowledgement for a pre- 
vious entry is sent. On completion of sending commands, it igadvisable to 
check the status with Command 7 before closing the link. 

The single-digit commands are: 


Turns ON Circuit 1 

Turns ON Circuit 2 

Turns ON Circuit 3 

Turns OFF Circuit 1 

Turns OFF Circuit 2 

Turns OFF Circuit 3 

Replays the status of the controller — see below for status mes- 
sages 

8 Globally resets all the status flags 
9 Read command counter 

0, #,* Not used, ignored 


NOOO F WNW Ee 


Status messages returned in CW are: 


xs Priority Turn-off Command 1, PIN 1, has been issued. Cleared 
by User Command 1, 4 or 8 

Yi Priority Turn-off Command 2, PIN 2, has been issued. Cleared 
by User Command 2, 5 or 8 

he Priority Turn-off Command 3, PIN 3, has been issued. Cleared 
by User Command 3, 6 or 8 
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a Circuit 1 is ON 
2. Circuit 2 is ON 
3” Circuit 3 is ON 


‘B’ Main power supply at the remote site is off (the controller in- 
cludes its own local battery to maintain status and auto-answer) 
a Controller has been powered on and circuits may be in de- 


fault/start-up states. Cleared only by issuing a Clear Status com- 
mand (User Command 8) 


X, Y and Z status message flags are cleared by setting (or clearing) their 
respective circuit, eg the X response indicating that Circuit 1 was turned off 
by a PIN 1 Priority 1 Command may be cleared by issuing a PIN 4 + 1, or 
4, command to either turn on Circuit | or leave it switched off. They are 
also cleared by the Global Reset Status Command 8. 

The command counter is a modulo 256 count of the number of active 
commands issued, ie after the count reaches 255 it rolls back to zero. Every 
time PINs 1-3 are sent, or User Commands 1, 2, 3, 4, 5, 6, 8 are issued, this 
counter is incremented by one; no increment is generated for commands 
that simply read back status or command count. The value is sent back as a 
CW message giving the hexadecimal value of the count. For example, a 
count of 15 will generate ‘OF’ in CW; a count of 123 will generate the CW 
message ‘7B’. The counter cannot be reset other than by switching off the 
controller to reset it and allows multiple users to keep a track of commands 
sent. 

There is a built-in delay between hearing a PIN or command and its 
response to allow use with one-piece telephones; units that mute the audio 
when sending tones may give problems if the un-mute delay is too long. 
The controller will send a 1800Hz tone and go off-line if no DTMF tones 
have been received for 20 seconds; there is no need to wait for this tone 
before hanging up. CW messages are sent with a 900Hz tone; multiple 
responses are sent in the order they appear in the list. 


Software 

The complete source code listing is too long to list in its entirety, but Table 
6.2 shows a few of the routines that are specific to this software, namely, 
retrieving data from the PIC user non-volatile EEPROM memory and the 
use of a stack in user memory to manipulate a series of bytes in sequence. 
None of the CW message coding is included in this software listing as it was 
implemented in a rather crude way, and a far more efficient CW coding 
scheme is given later. A complete listing, DTMFREM2, for the controller is 
available from the RSGB website. 


Remote control over an RF link 


When using an RF link for remote control, several new problems now arise. 
The foremost of these is that as the RF link is not necessarily bi-directional, 
acknowledgement of a successfully received command is only supplied by 
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CheckPinl 


mov lw 
call 
subwf 
btfss 
goto 
mov Iw 
call 
subwf 
btfss 
goto 
mov lw 
cal] 
subwf 
btfss 
goto 
mov Iw 
call 
subwf 
btfss 
goto 
mov lw 
return 


NotValidl 


mov lw 
return 


PushStack 


movf 
movwf 
movf 
movwf 
movf 
movwf 
movf 
movwf 
return 


ClearStack 


elit 


movf 


Table 6.2. Some of the routines specific to the telephone remote controller PIC code 


0 

GetEE 
Stack4 , W 
STATUST SZ: 
Notvalid1l 
1 ; 
GetEE 
Stack3 , W 
STATUS az 
NotValid1 
2 

GetEE 
Stack2 , W 
STATUS 4 Z 
NotValid1 
3 

GetEE 
Stackl , Ww 
STATUS Siez 
NotValid1l 
1 


Stack4 , W 
Stack5 
Stack3 , W 
Stack4 
Stack2 , W 
Stack3 
Stackl , W 
Stack2 


Stackl 
Stack2 
Stack3 
Stack4 
Stack5 


;looks for valid PIN1 in stack1-4 
;Correct PIN kept in EEPROM locations 0-3 
;PIN sent MSB first, MSB saved in LOWEST 
;EEPROM address so it looks correct in listing 
;Separately check each digit in the stack against 
; what is expected. 


;If all four received digits check OK, 
; return with 1 in w, else return O for error 


;Move new data into beginning of stack, and 
; push up all other data, throwing away the Oldest. 
;Here the stack is 5 high, but could be extended 


;Prevent spurious PIN entry from commands 


;read byte from non-volatile EEPROM memory 


EEADR 
STATUS, RPO 
EECON1 , RD 


;enter with address to be read in Ww 
;ram page 1 


STATUS , RPO j;ram page 0 


EEDATA , W 


;Exit with data in Ww 


CHAPTER 6: REMOTE CONTROL AND TELEMETRY 


the controlled function, such as a beacon transmission, going off or on. Ifa 
transmitter and receiver pair is used at the remote site the link will still 
probably be simplex and commands cannot be verified as soon as they are 
issued. 

A solution to this is to add an input to the controller monitoring the 
receiver squelch, so that command acknowledgement is sent only when the 
transmitting station drops carrier. Another output from the controller is 
needed to operate the transmit/receive line. This assumes an FM or AM 
link is used, which is usually necessary for DTMF coding to ensure proper 
frequency accuracy. One issue, still to be resolved with this system, is cop- 
ing with what happens if the squelch is being held open by a weak interfer- 
ing signal that does not affect the command transmission. The solution 
adopted is to wait for a suitable time — say 10 to 20 seconds — for the squelch 
line to crop. If it doesn’t close then the acknowledgement transmission is 
sent anyway, and hopefully will be received by the controlling station who 
will now be alerted (by the delay) that the channel may have some interfer- 
ence present. 


Link security and coding issues 


The next issue is one of security. Any casual listener can listen in to the 
commands being sent, and if the same PIN is used each time it is easy to 
monitor these and decode the digits, so allowing unauthorised access and 
the possibility of false or malicious commands being issued. The solution is 
to adopt a scheme where the PIN changes for each access — only authorised 
users have the list of which valid PINs will be accepted each time. A similar 
scheme is used for modern automobile door locks and immobilisers, where 
a small radio-operated keypad transmits a continuously changed message 
that is known only to the controller each time a button is pressed to permit 
entry. 

A pseudo-random sequence can be used to generate a series of PINs, 
provided the method of generating the sequence is sufficiently concealed 
so that a casual interceptor cannot predict which ones will occur next time. 
We met PRN sequences in the last chapter where a random sequence of 
data was generated from a feedback shift register combination. The require- 
ment here is broadly similar, except that a range of numbers is now needed 
instead of a single bit changing. The sequence needs to be much longer to 
prevent the algorithm being worked out by an interceptor, and it has to be 
possible to easily generate different sequences for different on-air links or 
users. 

A convenient way of generating pseudo-random numbers with simple 
mathematics is by use of the equation: 


N=(A.N+ B) mod C 


Each new value of Nis generated by multiplying its previous value by A, 
adding Band taking the modulus to Cof the result (the remainder left after 
repeatedly subtracting C) so the resulting value of Ncan range from zero to 
a maximum of C- 1. A, Band C have to be ideally chosen so that the 
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sequence is long enough and has no repeats. However, even for arithmetic 
limited to 16-bit integers a wide range of possible values are available, and 
16-bit maths is reasonably straightforward to write in PIC assembler code. 
The maximum length of the generated sequence cannot be any longer than 
Cbefore it repeats, and for certain choices of A, Band Ccan be a lot shorter. 
To ensure maximum length it is advisable to check the sequence genera- 
tion by modelling it in software first - in any case this step will be needed to 
generate the list of PINs for each user and a spreadsheet programme is 
adequate. As the modulus function is not straightforward to programme in 
assembler code from first principles, the value for C’can often conveniently 
be made a power of two, such as 2° = 8192, so taking the modulus now 
becomes a case of just extracting the correct number of lowest significant 
bits of the result from the multiply-and-add calculation. 

As an example, using the values A= 17, B= 799 and C'= 256, the first 
few values starting with an initial ‘seed’ value for Nof 1 are 1, 48, 79, 94, 93, 
76, 43, 250, 185 etc which certainly look at first sight as if they may be 
random. 

Altering any of A, Bor Cresults in a widely differing sequence, especially 
after the first few terms, and the values A, Band Care sometimes called the 
key when used in encryption. This technique of random number generation 
is used within many programming languages — in Basic it is invoked by the 
RND function. 

To generate such a sequence on a PIC requires a multiplication routine. 
The latest high-range PICs, the 18Fxxx family, include an 8 x 8-bit hard- 
ware multiplier which gives a 16-bit result and can be cascaded for larger 
numbers. However, a multiplication routine has to be made up for the smaller 
microcontrollers. In binary, traditional long multiplication is reduced to a 
series of multiply by two with conditional add instructions. In the sum A x 
B for example, the value of B is repeatedly multiplied by 2, which is the 
same as shifting it left by one bit each time, and if the corresponding bit in 
A is set, accumulating the result as illustrated in the ‘Binary multiplication’ 
box opposite. 

The listing in Table 6.3 is for a subroutine that generates the next pseudo- 
random number in a sequence from its previous value, within the range 0 
to 8191. The constants to be used for the calculation are limited to an eight- 
bit value for A (stored in the register Avalue) and 16 bits for Bin the two 
registers Bhi/Blo. The previous value, to be modified, is passed into the 
subroutine with its most significant bits in the register Whi and the lowest 
bits in the working W register. The value of Cis made equal to 8192 and the 
modulus, or truncation, of the sum is done by taking only the lowest five 
bits of the higher-order byte of the result. Note that with the values used in 
this sequence, the register AccHi is not needed, although it is included within 
the software listing for completeness. 


Expanding I/O ports 


Often more output functions need to be controlled than there are available 
pins on the controller. One solution is of course to use one of the functionally 


| 
i 
i 
| 


| later this has to be saved separately. 
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Binary multiplication 


A= 147 or in binary 10010011 | 
B = 42 or in binary 00101010 


We also need a working register, usually called an accumulator, X. We will shift B, 
while testing the bits in A, starting with the lowest significant ones, and depending 
on the result of the test decide whether to add the shifted B value into X or not. 


Bit 0 of A= 1, so set the working accumulator, X = B. 
Now shift B left, so multiplying by 2. Now B = 1010100. 


Bit 1 of Ais also 1, so this new B value is added into the accumulator, X = X + 2.B | 
orX=B+2.B 


Shift B left again, multiplying the original value by 4, B= 10101000. | 


Now bit 2 of A is a zero so we do nothing and continue. After the next shift bit 3 | 
of A is also zero So we continue again. | 


After the fourth shift B= 1010100000 and is now 16 times its original value. At 
this stage, Bit 4 of A is again set, so this new value of B is added into the | 
accumulator. Now X =B + 2.B+ 16.B 


The next two shifts are not added to the accumulator as bits 5 and 6 of A are zero, ) 
but the final shifted result of B, equal to 128 x the original value, is included so now | 
X=(1+2+16+4+ 128) xB. 


This process is illustrated below. 


X 
101010 B 
1010100 Bx2 


A 
1 
1 
0 
0 
1 1010100000 Bx16 
0 

0 

1 1010100000000 Bx128 
1100000011110 Bx(128+16+2+1) | 


From this it is clear that not only does a 16-bit register (the accumulator) have to | 
be allocated to contain the results of an 8 x 8-bit multiplication but the B value also | 
has to be stored as 16 bits to allow it to be shifted at each stage. Furthermore, the | 


| value of B in its original form is destroyed, or at least modified, so if it is needed | 


| 
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similar devices that has more I/O registers and pins. However, these 
generally cost rather more than the smaller devices, and still require 
interfacing from the 0/5V level to whatever is needed to drive the controlled 
equipment. 


A device that simplifies interfacing to relays and other higher-powered 


loads is a serially loaded driver chip such as the UC5841. These typically 
have a serial input where data is clocked into a shift register sequentially via 
data and clock lines, then stored in output latches by a load pulse on a third 
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Table 6.3. Pseudo-random sequence generation 


Nextcode 
movwf 


eink 
clIrf 
clgt 
mov Iw 
movwf 
MultLoop 

rok 

btfss 
goto 


movf 
addwf 
btfss 
goto 
incf 
btfsc 
inc 
Add1 
movft 
addwf 
btfsc 
incf 
NoMult 
bcf 
elt 
rif 
decfsz 
goto 


movf 
addwf 
btfsc 
incf 
btfsc 
incf 
movf 


addwf . 


btfsc 
incf 


mov Iw 
andwf 


movf 
movwf 
movf 
return 


110 


;Takes in whi/w, uses Avalue & Bhi/Bl, calculates new whi/w 


Temp 


ACCLo 
AccMe 
ACCHi 

8 
Counter 


Avalue 
STATUS 
NoMult 


Temp , 
AccLo 
STATUS 
Add1 

AccMe 
STATUS 
ACCHi 


whi , W 


AccMe 
STATUS 
ACCHi 


STATUS 
Temp 
whi 
Counter 
Mu1tLoo 


’ 


p 


Blo , W 


ACCLo 
STATUS 
AccMe 
STATUS 
ACCHi 


Bhi , W 


AccMe 
STATUS 
ACCHi 


Ox1F 
AccCMe 


AccMe , 
whi 
AcCLo , 


;whi/Temp is register to shift & add 


;Multiplicand limited to 8 bit value 


;working bit into carry 


;get shifted wlo value 
; and add into accumulator if 1 in 
3; appropriate bit in Avalue 


;Multiply by 2 ready for next partial product 


;Acc = A.W 

sAcCC = A.W +B 

;AccMe/Lo = (A.W + B) MOD 8192 
;wW/whi = (A.W + B) MOD 8192 


line. The chips incorporate high current drivers of up to several hundreds of 
milliamps capability, which can operate at high voltages for directly driving 
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relays. They usually contain back-EMF diodes for protection from the  Fig6.2.Usingserially 
transients generated by switching the inductive relay coils. Compared with !0aded relay driver 
aE HE Spee chips 
the relay driver circuit shown in Fig 4.3, five more I/O lines are now released 
for other interfacing functions and, if more outputs are needed, the driver 
chips include a serial output from the final stage for cascading multiple 
devices. In theory there is no limit to the number that can be cascaded, but 
as the entire data set has to be serially clocked in each time a single relay is 
switched, 32 or 40 individual outputs is probably a sensible upper limit. 
Using three of these devices, Fig 6.2 shows the circuit diagram of an 
interface for controlling up to 24 relays or other DC switched loads. Table 
6.4 is a subroutine for the 16Fxxx family of PIC devices for transferring the 
contents of three data storage registers across the serial interface to a trio of 
cascaded UC5841 chips. 
Fig 6.3 shows the circuit diagram for a complete telecommand system for 
switching up to eight circuits at a remote facility, making use of the concepts 
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Table 6.4. Code for sending data to serial driver chips 


| ;Data stored in D1/D2/D3 
;Output lines to UC5841 devices, Dout, Clk and Strobe 
} 


SendRelayData ;MSB first for UCN5841 relay driver 
moviw d'‘'24' ;24 bits, data clocked in MSB first 
| movwf Counter ;Data stored in D3/D2/D1 
RelayLoop 
) bcf clk ;data changes with -ve edge of clock 
rif D1 ;Data transferred D3MSB >> DILSB 
rif D2 
Cle D3 ; 
DLESSit STATUS 3G ;Test and transfer to Dout line 

; bcf Dout 
bthse = STATUS..,2G 
bsf Dout : 

bsf clk ;Sstobe in data bit 
: nop ;Short delay to lengthen clock pulse 
| nop 
decfsz Counter ;do this 24 times 
goto RelayLoop 
: rif DL ;Restore original pattern and preserve registers 
rif D2 
rif D3 
| bcf clk 
nop 
: nop 
bsf Strobe ;now strobe in the entire data set 
nop 
| nop a 
bcf Strobe 
return 


outlined so far. DTMF tones as generated by the majority of 144 and 
432MHz handi-talkies are used to allow the operator to enter the digits. 
Three completely separate PIN sequences are maintained so that up to three 
users can independently gain access to the control system without having to 
inform each other of the position in the sequence. A readback function is 
included to allow users to read the status of the eight controlled circuits as 
well as the current position in each of the three code sequences. This latter 
function enables each user to keep track of the number of commands that 
may have been issued by the other authorised operators. 

The software listing is too long to show here, but a complete listing is 
available from the website under the name ‘DTMFRAD.’. Note that the A, 
Band C’values for the three PIN sequences included in this listing are not 
those actually used for any operational version of this system! 


Telemetry 


Remote monitoring or telemetry usually involves measurement of analogue 
parameters such as voltage, current consumption and temperature, and also 
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the status of various items such as door and window switches as part of site 
security, equipment functional status etc. How the data is returned to the 
operator is also significant. While DIMF tones make commands easy to 
generate, using these on the return link is not so convenient. Data transmis- 
sion is probably the most versatile system, but will normally require a PC to 
decode and display the received data. For a few parameters, returning these 
as automatically generated CW messages has a certain attraction, as a handi- 
talkie can continue to be used for both command generation and telemetry 
monitoring. 

But first, some additional functions and hardware have to be added around 
a PIC to turn it into a useful telemetry system. Fig 6.4 shows the circuit 
diagram of a remote telemetry interface that operates in conjunction with 
the command interface of Fig 6.3. This telemetry module was designed to 
monitor AC voltage and current of the mains input to the GB3SCx micro- 
wave beacons installed on a remote hill in Dorset. Parameters that required 
to be monitored remotely were the mains voltage and current supply to the 
cabin, DC battery float-charge voltage, shack temperature and the status of 
two door switches. Some spare capacity is included in the telemetry hard- 
ware for further expansion. The AC power interface produces fully isolated 
0 to 5V signals for the A/D converters, with full scale corresponding to an 
RMS current of 2.5A and voltage of 250V. 

Temperature is measured via a thermistor and resistor, the values of the 
resistor and positioning on the 0-5V scale being determined experimen- 
tally to give an approximately linear voltage swing with temperature, giv- 
ing an accuracy better than 2° in the range 0-30°. A better solution, giving 
a more accurate reading, would be to use one of the temperatufe measure- 
ment ICs such as the LM35 family of devices that give a linear voltage 
proportional to temperature, but the thermistor was already to hand and 
only required a two-wire interface, so it was used here. 


External A/D converters 


Serial A/D converter chips have already been mentioned in Chapter 4, and 
here the use ofa typical device is described; the four-wire interface to the PIC 
processor can be seen in Fig 6.4. The MC3208 device is a 12-bit converter 
with eight input channels which can be selected individually by an internal 
analogue multiplexer, so that up to eight separate voltages can be measured 
to aresolution of 5/4096 or approximately 1.25mV. A full data sheet for this 
and similar devices can be obtained from reference [3]. Op-amp unity gain 
buffers are included on the two external inputs from the AC mains interface 


_ to provide an element of EMC and protection against transients, working in 


conjunction with the RC networks on the input lines. All voltages are scaled 
to be within the range 0 to 5V, suitable for the A/D converter. 

Table 6.5 lists the assembler code subroutine needed to read one channel 
from this device, the channel to be read being specified by loading it into the 
W register before calling the routine. First the set-up information, including 
channel number, has to be clocked into the A/D chip, and this device takes 
up four interface lines to allow this data input. After the conversion is 
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Table 6.5. PIC routine to read from external MC3208 12-bit serial, eight-channel A/D convert- 
er chip 


;Reads MCP3208 A/D converter 


| sUses registers Alo , Ahi 


| ReadAD 


movwf 
rif 
rif 
Clt 
rif 
AL 
Gre 
cunt 
bcf 
bcf 
bsf 
bsf 
bcf 


bsf 
bsf 
bcf 
mov Iw 
movwf 


ADChanLoop 


| ADLoop 
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rif 
btfsc 
bsf 
btfss 
bcf 
bsf 
bcf 
decfsz 
goto 
bsf 
nop 
bcf 
nop 
bsf 
nop 
bcf 
mov lw 
movwf 


bsf 
bcf 
btfsc 
bsf 
bcf 
[ert he 
rif 
decfsz 
goto 
bsf 
return 


Temp 
Temp 
Temp 
Temp 
Temp 
Temp 
Alo 
Ahi 
ADCLK 
ADCS 
ADIN 
ADCLK 
ADCLK 


ADIN 
ADCLK 
ADCLK 

3 
Counter 


Temp 
STATUS , C 
ADIN 
STATUS , C 
ADIN 

ADCLK 
ADCLK 
Counter 
ADChanLoop 
ADCLK 


ADCLK 
ADCLK 


ADCLK 


pdt 2s 


Counter 


ADCLK 
STATUS , C 


-ADOUT 


STATUS *, GC 
ADCLK 

Alo 

Ahi 
Counter 
ADLoop 
ADCS 


, Counter, Temp and lines ADCS, ADCLK, ADIN, ADOUT 


;w contains channel to read 


;Position channel no. at MS end, ready to shift out 
; MSB first, else 4 bits of last reading remain in MSBs 


;Just in case 


;Enables device 
;Start bit 


;First clock in setup information 
;Single ended mode 


;Now clock in channel no. 


;Terminology ‘IN’ & ‘OUT’ refer to 
: MCP3208 pin names ! 


;Trigger Sample & Hold, ADIN don’t care 
;This edge triggers output of Bil 
;Dummy read null bit 

;Data MSBit wil appear now 


:Now serially clock out the 12 data bits 


;MSB 11 
;Read data bit into carry 


;Triggers O/P of next bit 
;Rotate into AD Data registers 


;Returns A/D to standby 
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Table6.6 Routine to read 8 status bits via 74HC165 shift register interface 


;Shift register connected: Load - StsLoad, Clock - Serclk, Serial Data out - StsData 


| ReadStBits ;Get data from shift register, returned in LineData 

bef StsLoad ;Strobe in parallel data on -ve edge 

nop . 

nop | 
| bsf StsLoad ;First bit appears at StsData immediately after Load pulse 
cirf LineData 


movlw d’8' 
movwf Counter | 


ShRegLoop8 . 
btfsc  StsData ! 
bsf STATUS , C ) 
btfss StsData ) 
bcf STATUS , C | 
rif LineData | 
bsf Serclk ;Data changes on +ve clock edge 
nop ;Clock through next bit of data 
nop | 
bcf Serclk 
decfsz Counter ;Until all 8 bits are done 


goto ShRegLoop8s 


| 

| 

return 
La 


triggered, the data is clocked out one bit at a time, starting with the MSB into 
the PIC registers Ahi and Alo. Interestingly, and unlike the A/D converter 
within some members of the PIC family, there is no need to wait for the 
conversion to complete before reading out the result. Most A/D converters 
work on a successive approximation principle, where the reading is gener- 
ated one bit at a time starting with the MSB. Hence, when clocking data out 
serially, each bit can be read as soon as it is generated. Some A/D chips allow 
the option of clocking out data LSB first, and in this instance it is necessary 
first to wait for conversion to complete. 


Status telemetry 


Referring again to Fig 6.4, a 74HC165 shift register is included to enable up 
to eight on/off status lines to be read, while only tying up three of the PIC 
I/O pins. Two of the shift register inputs are connected through transistor 
buffers to switches mounted on doors and windows. The buffers are there 
to give some isolation against short-circuits and transients that might other- 
wise get passed through to the logic circuitry. Another input comes via a 
transistor buffer and is designed to monitor a status voltage from a separate 
area of the beacon system. If more than eight bits are wanted, a second or 
further 74HC165 device(s) can be cascaded by connecting the final stage 
output to the serial input of the next one, then connecting the load and 
clock pins together. The software then has to be changed to clock out the 
necessary number of bits into a set of registers to hold the data. 
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Transmitting the data 

This telemetry system was designed to operate as a stand-alone unit, send- 
ing data that could be easily read by any operator with no more than a 
UHF handheld radio. The outputs of the A/D converter, consisting of a 
binary number from 0 to 4095 and representing 0-5V input for each chan- 
nel, have to be scaled to give the correct value as a decimal number for the 
appropriate parameter being measured, and converted into decimal for trans- 
mission. 

Each of the four analogue parameters has a different scaling factor de- 
pending on the potential divider or other analogue network used to gener- 
ate the 0-5V input signal and in most cases a straightforward scaling from 
the 0-4095 value is all that is needed, ie multiplication or division of this 
number by a constant. As an example we will take channel number 02 
which measures the DC battery float charge voltage. Table 6.7 lists the 
portion of code that performs this function. With 12 bits of measurement 
resolution available, more than sufficient accuracy can be obtained by sim- 
ply scaling the voltage by a factor of 0.25, so the 0-5V input range corre- 
sponds to an actual allowed DC voltage range of 0-20V, more than enough 
to show the battery condition. So now a 0-20V signal generates a code 
from 0-4095 which has to be converted to binary coded decimal (BCD) 
numbers ready for transmission. The scaling factor is therefore equivalent 
to multiplying the value Nfrom the A/D converter by 20/4096, or dividing 
by 204.8. We saw earlier that multiplication on a PIC requires a special 
routine to perform, and then only integer arithmetic is possible. By em- 
ploying some crafty tricks we can simulate decimal fractions, The tech- 
nique used is to scale to a value of 0 to 2000 then just put in a decimal point 
at the correct place; the scaling factor now becomes 2000/4096 = 250/512. 

We already have a routine for multiplication, although that listed in Ta- 
ble 6.3 needs to be changed slightly to accept the 12-bit values used here. 
Division, however, is a more complex routine to write from first principles, 
involving repeated shift and subtract, and will usually give non-integer re- 
sults; here we restrict division to a binary shift only meaning, for example, 
that a number can be divided by 512 by shifting the result nine bits to the 
right. A generalised routine for binary division by 2" is shown in the Div2N 
routine listed, so now the scaling operation for the DC supply voltage is 


_ reduced to a single multiplication by 250 followed by a nine-bit right shift. 


The other parameters are scaled appropriately: 


ChannelOQ 0-250Vac x 625/1024 = 0-2500 
Channel 1 0-2.5Aac x 625/1024 = 00-2500 


Channel 3, the temperature, is rather more complicated but the following 


equation was determined experimentally: 
T= (3000 — A) x 51/2048 


This gives a temperature reading accurate to a couple of degrees within the 
range of at least 0-30°. 
We now have a binary number stored in two bytes which then has to be 


;Channel 2 Data 
mov lw 
call 


mov lw 
movwf 
mov lw 
movwf 


call 
mov lw 
call 
movf 
movwf 
movt 
movwf 
call 


movf 
call 
movf 
call 
mov lw 
call 
movf 
call 
movf 
call 
mov lw 
call 
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DC Supply 0 - 20v 
2 
ReadAD ;A/D channel 2 
0x00 
Bhi 
d’250’ 
Blo 


;Multiplicand = 250 


Multiply 250 
d’9' 
Div2N 
AccMe , W 
Ahi 

AccLo , W 
Alo 


BinToBCD 


PAGE =a 


i] 
> 


;ACC 250 / 512 = 0 - 2000 = 20.00 v 


BCDMe , W 
CWHiNibble 
BCDMe , W 
CWLONibble 
wen 

Sendcw 
BCDLO , W 
CWHiNibble 
BCDLO , W 
CWLONibble 
ayn 

Sendcw 


;Main code continues... 


Multiply 


Mul tLoop 


Blo , W 


;Ahi/Alo * Bhi/Blo, result in AccLo/AccMe/Acchi 


AccLo ; A&B destroyed » max 24 bit product 
AccMe 
ACCHi ;Clear accumulators 
Temp ;Temp will contain MSBs of shifted B 
fall We ;A and B limited to 12 bit values only. 
Counter 
STATUS , C 
Ahi ;working bit into carry 
Alo. ;Repeatedly adds shifted version of B 
STATUS] 726 ; into Acc depending on working bit of A 
NoMult 

;get shifted Blo value 


Table 6.7. PIC code to read a voltage and convert to decimal values 
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Table 6.7 (continued) 
addwf  AccLo ; and add into accumulator if 1 in 
btfss STATUS 4, .C ; appropriate bit in Avalue 
goto Addi 
incf AccMe 
btfss STATUS , Z 
goto Add1 
incf ACCHi 
| Addi 
movf Bhi , W 
addwf AccMe 
btfss STATUS) ne 
goto Add2 
incf AcCcHi 
Add2 
i movt Temp , W 
addwf AccHi 
| NoMult 
bcf STATUS , C 
mit Blo 3B = B * 2 ready for next partial product 
elt Bhi 
rif Temp 
decfsz Counter 
goto MultLoop 
;ACCHi/Me/Lo = A * B 
return 
Div2N ;Divides Acc by 2AN. N in W 
movwf Counter ; nb. Does not work if entered with 0 - 
DivLoop 
bcf STATUS , C 
ere ACCHi 
crf AccMe 
ia ebe ACCLo 
decfsz Counter 
goto DivLoop 
return 
| BinToBCD ;Takes in Ahi/Alo, calculates packed BCD equivalent 
GLEE BCDHi ;also uses Temp, Counter, destroys Ahi/lo 
Elry BCDMe 
clirf BCDLo 
mov Iw d’16' 
movwf Counter 
' BCdLoop 
rif Alo 
rt Ahi 
rif BCDLo 
cee BCDMe 
eltin BCDHi 
decfsz Counter ;Need a final shift only, so loop count here 
goto BCDgo : 
goto BCDone 
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Table 6.7 (continued) 


movf BCDHi , W 
addiw 3 | 
movwf Temp . 
btfsc Temp , 3 

movwf  BCDH1 ;If BCDHI >= 5, add 3 and store back 


movf BCDHi , W 

addlw 0x30 

movwf Temp 

btfsc Temp , 7 

movwf  BCDHi ;Adjust BCDHI if > 80 


movft BCDMe , W ;Repeating for middle then low digits 
» addiw 3 

movwf Temp 

btfsc Temp , 3 

movwf  BCDMe 


movf BCDMe , W 
addiw 0x30 
movwf Temp 
btfsc Temp , 7 
movwf  BCDMe 


movf BCDLo , W : 
addlw 3 

movwf Temp 

btrse. <-Temp 3 
movwf  BCDLO 


movt BCDLo , W 
addlw 0x30 
movwf Temp 
btfsc Temp , 7 
movwf  BCDLO 


goto BcdLoop 


| BCDone 
return 
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converted to a form readable by an operator. This is the function of the 
routine BiNTOBCD shown in Table 6.7 which takes in a 16-bit binary value 
and generates five BCD digits packed two at a time into the registers BCDHi/ 
Me/Lo. 

This is not an easy routine to describe, but is one that has appeared in 
many computing journals and articles over the years as an example of the 
‘best’ way to undertake this rather difficult conversion. The easiest way to 
work out how it functions is simply to start with a large piece of paper and 
a few trial numbers, then work through the calculation one bit at a time — it 
really does work! 
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Table 6.8. Compact CW character storage and message coding 


/ Sendcw ;Sends a single CW character stored in W 
;Keys BUZZ line to activate audio tone 
bcf GieFlag 
btfsc  INTCON , GIE ;Inhibit all interrupts to avoid corrupting 
bsf GieFlag ; CW data out, but save its status for return 
bef INTCON , GIE ; 
addlw OxE0 ;Enter with ASCII character in w 
call CWTable ;Subtract 32 (add 256 - 32) to point to table entry 
movwf  CwChar ;RETLW Doesn’t affect STATUS, so check for zero separately 
movf CwChar ; check for invalid returned code here 


btfsc STATUS 32) Z 
goto NoChar 


movlw _b’00000111’ 
andwf CwChar , W ;Extract element count into w 


movwf Counter 


mov lw 6 


subwf Counter , W ;w = Elcount - 6. If +ve/0 then C=1, so > 5 els 


ptiss: WaSTAIUS Ee 
goto Send5 


rrf Counter ;Puts LSB (first symbol) into C as 110 =. 
call SendEle ;First . or - for 6 element characters 
mov Iw 5 
movwf Counter ;Force count to 5 for rest of the elements 
' Send5 
rif CwChar ;Element to be sent into C. 
call SendEle F count already in Counter 
decfsz Counter 
goto Send5 
_ NoChar ;Inter word gap, and invalid codes. 
call CwDelay 
call CwDelay ; 
btfsc GieFlag 
bsf INTCON , GIE ;Re-enable Timer interrupt if appropriate 
return 
SendEle ;Data’ in: STATUS, °C; 0 =-dit- i= dah 
bsf BUZZ ;Enable audio 
btfss STATUS , C ;test for dot or dash 
goto SendDot 
call -CwDe lay 
call CwDe lay 
| SendDot 
call CwDe lay 
bcf BUZZ ;End tone 
i call CwDe lay ;inter element gap 
return 
ba Eien RAN Aas 
| CwDelay 
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Table 6.8 (continued) 


: 
} 


} 


mov lw 

movwf 
CwDelLoop 

call 

decfsz 

goto 

return 


Delaylims 
mov lw 
movwf 
BasicDLoop 
nop 
nop 
decfsz 
goto 
return 
org 0x3A0 
CwTable 
movwf 
mov lw 
movwf 
mov 
addwf 
retlw 
retlw 
retlw 
retlw 
retlw 
retlw 
retlw 
retlw 
retlw 
retlw 
retlw 
retlw 
retlw 
retlw 
retlw 
retlw 
retlw 
retlw 
ret lw 
retlw 
retlw 
retlw 
retlw 
retlw 
retlw 
retlw 
retlw 


retlw 


d’84' 
DelCcount2 


Delaylms 
DelCcount2 
CwDelLoop 


d’197' 
DelCcount 


DelCcount 
BasicDLoop 


;Adjust this value to get suitable dot period 


;Cycle time = lus 
;Delay = 5.N + 12 = 997us 


; + 3us in higher loops = N . 1ms 


;Force tables to end to avoid page boundary problems. 
; CW Characters in compressed form. 


Temp 

3 

PCLATH 
Temp , W 
PCL 


Binary pattern 


b’00000000' 
b’00000000' 
b’10010110' 
b’00010101' 
b’ 00000000" 
b’00000000' 
b’ 00000000" 
b’11110110' 
b’ 10110101" 
b’01101111' 
b’01000101' 
b’00000000' 
b’10011111' 
b’00001111' 
b’10101110' 
b’10010101' 
3) opt ba a Ba a By 
b’01111101' 
b’00111101' 
b’00011101' 
b’ 00001101" 
b’00000101' 
b’10000101" 
b’11000101’ 
b’11100101' 
b’11110101' 
b’00000000' 


b’00000000' 


;Set page register 


;Recover offset 
;Generate table address. 


Char 
[sp] 


" O CON AU PWNFP O™M: 


Hex 

00 Space also used for invalid characters 
00 
96 
a5 
00 
00 
00 
F6 
B5 
6F 
45 
00 
OF 
OF 
AE 
95 
FD 
7D 
3D 
1D 
OD 
05 
85 
cS 
E5 
F5 
00 
00 


Coding for Cw characters of up to 
6 elements. Stored as : 
Bits 7 to 3 make first five Cw elements 
Reading Left to Right 
Coded as 0 = dit 1 = dah 
Bits 2-0 are number of elements except for 
110 Ist element is a dit 
111 1st element is a dah 
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Table 6.8 (continued) 
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retlw 
retlw 
retlw 
retlw 
retlw 
retlw 
retlw 
retlw 
ret lw 
retlw 
retlw 
ret lw 
retlw 
retlw 
retlw 
retlw 
retlw 
retlw 
retlw 
retlw 
retlw 
retlw 
retlw 
retlw 
retlw 
retlw 
retlw 
retlw 
retlw 
retlw 
retlw 


b’00000000" 
b’10001101' 
b’00000000' 
b’01100110' 
b’*00000000' 
b’01000010* 
b’10000100' 
b’10100100' 
b’ 10000011" 
b’00000001' 
b’00100100' 
b’11000011' 
b’00000100' 
b’00000010' 
b’01110100' 
b’10100011' 
b’01000100' 
b’ 11000010" 
b’ 10000010' 
b’11100011' 
b’01100100' 
b’11010100' 


bLOLOOCORdN ia: 


b’ 00000011" 
b’ 10000001" 
b’00100011' 
b’ 00010100" 
b’01100011' 
b’10010100' 
b’10110100' 
b’11000100' 


Ni GS SS SS a Us WSO Oe Se An ee Oe mR OOO aan LV SIE 


00 
8D 
00 
66 
00 
42 
84 
a4 
83 
01 
24 
C3 
04 
02 
74 
A3 
44 
c? 
82 
E3 
64 
D4 
43 
03 
81 
23 
14 
63 
94 
B4 


c4 


} 
| 
; 
| 
i 
| 
5 
/ 
| 
) 
: 
{ 
1 


: 


Formatting for transmission 


In this telemetry module, the calculated 
values are sent back to the user as CW 
messages. The data in the three packed 
BCD bytes, up to five digits from 0 to 9, 
have to be coded into a CW message, 
with the decimal point inserted in the 
correct place. As full five-digit accuracy 
is not necessary for any of the measure- 
ments needed here, only the most signifi- 
cant digits are extracted for sending back. 
We met CW message generation in 
Chapter 4 where a beacon keyer sent pre- 
programmed characters. Here the CW 
was stored in an inefficient way as part 
of the programme structure and not con- 
ducive to large, limited-memory, appli- 
cations. Here a much more compact 
method of storing and decoding CW 
characters for arbitrary transmission is 
shown. Table 6.8 gives a listing of the 
routine to extract CW from the com- 
pressed data stored in CwTable. CW 
characters are stored in a compressed 
form in a table as one byte per character. 

For each of those CW characters that 
consist of five or fewer symbols, such as 
all the letters and numbers, the three low- 
est bits of the stored code represent the 


length of the character in symbols, and the remaining five bits are coded, 
from left to right, such that a ‘0’ represents a dot and a ‘1’ represents a dash; 
unused positions are left at ‘0’. So the letter ‘J’ with four symbols is stored as 
‘01110100 and ‘9’ with five symbols as ‘11110101’. 

The remaining punctuation characters with six symbols are treated dif- 
ferently. The ast five symbols are stored as above, and if the first symbol is 
a dot the length code is set to 6, or ‘110’. If the first symbol is a dash, this 
becomes 7, or ‘111’. So now a full-stop (- ---- —) is stored as ‘10101110’ but 


a comma ( 


References 


——ee— — 


) is stored as ‘10011111’. 


[1] Data for DTMF controller chips: www.zarlink.com. 
[2] Telephone line interconnection standards: www.babt.co.uk. 
[3] MC3208 data sheet: www.microchip.com. _ 


Grae Alb abe ts 


More microcontroller projects 


Hand-held, low-power RF controller 


In Fig 7.1 a 16F84 PIC is used as part of a low-power RF remote control. 
The bulk of the work within this unit is done by the remote control chips 
themselves which operate with a pulse-width modulated data stream. A 
fixed address is set by pin selection on the transmitter and receiver chips, 
and these addresses have to match for data to be recognised by the re- 
ceiver. Four bits in the sequence are available for data, allowing up to 16 
circuits to be activated. An alternative receiver chip, the HT12F, hard wires 
these four address bits instead and allows control of just one circuit with 
higher security — this is the version usually adopted for jobs such as garage 
door openers. Data security against false alarms is guaranteed by the oper- 
ating protocol which requires the receiver to correctly decode three succes- 
sive matching codes before it will trigger an output. Further reliability can 
be ensured by adding an RC filter to the output line, ensuring in effect that 
many correct codes have to be decoded before the action is triggered. 

The primary use for these chips is for infra-red remote controllers as used 
with television sets, but the data clock rate can be set over a wide range, 
making them useful for carrying data on RF or by other slower media. 
Here, low-cost modules designed for the licence-free 432MHz band are 
employed. As this falls inside an amateur allocation, we do not need to 
comply with the limited antenna restriction for licence-free operation, and 
can extend the range by use of larger antennas and power amplifiers. How- 
ever, as the frequency stability of these low-power modules is a few tens of 
kilohertz, and modulation is rather wide, there is potential for causing QRM 
if high radiated power is adopted. 

The hand-held controller is operated from a 4.8V battery and normally 
the PIC isin sleep mode. Itis woken up by any key being pressed, whereupon 
the key press is decoded and the appropriate four-bit code is sent to the 
HT12E. At the receiver, depending on what is wanted, either a four-to-16 
line decoder chip can be used to allow all 16 circuits to be controlled 
independently, or just buttons corresponding to 1, 2, 4, 8 on the keypad can 
be activated to control each of the data lines individually without the separate 
decoder chip at the receiver. The PIC controls power to the transmitter 
module so that it is only on when a key is pressed, ensuring power 
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Fig 7.1. Low-power 
remote control aN 


Module 
Address 


Tx module 


COPNEDIoOPhfofroj— 


+V 

p 33k 
100n 

Matrix keypad 5 
(a) isi E121 
78L05 
Vec 
(0) I +12V 
G ‘ 
Ant Dout 
100n 100n 
Rx module 


(Fosc 150kHz) 


Module 
Address 


OIrIopoys fur 


(b) ew 
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Table 7.1. Complete PIC source code for hand-held remote controller 


;KEYBENC.ASM Read hex keypad and give BCD + Strobe output 
;timings based on 455kHz /4 clock (8.79us) 


LIST P=16C84 


cblock 0x0D 
DelCount ;Delay counter 
Temp 
Counter ;General purpose counter 
Kbdcode ; ) 
LastKey | 
endc ; 
;code starts here 
org 0 
boot nop 
| clrw 
movwf  INTCON ;disable interrupts 
H goto startup ;jump to main code 
| ints retfie ;interrupt service routine code 
startup 
bsf STATUS, RPO ;ram page 1 
movlw  b'0Q0000000' ;Set A as outputs Column address + nstrobe 
movwf PORTA ; 
movlw  6'11110000' ;Port B Row inputs and data output 
movwf = PORTB 
| bcf OPTION_REG , NOT_RBPU ;enable pull ups 
bcf STATUS , RPO ;ram page 0 
clrf — Kbdcode 
bsf INTCON , RBIE ;PortB change interrupt enable 
: MainLoop ;loop here forces strobe low 
movf —§ PORTA , W 
| jorlw  b'00001111' 
i movwf = PORTA ;preserves Strobe, columns all high 
bcf PORTA , 0 
moviw 0x00 
| movwf Kbdcode 
: call Delay 
comf PORTB , W ;Read row code (any 0 means key pressed) 
andIw _b'11110000' | 
| btfss - STATUS 4, .Z 
: goto GetRow ;this row detected | 
| bsf PORTA , 0 | 
bcf PORTA , 1 ;Address col 2 | 
moviw 0x04 | 
movwf  Kbdcode 


INCLUDE "P16C84.INC" 


CONFIG b'11111111110001" 


;PU Timer on, WD Timer off, Xtal osc 
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Table 7.1 (continued) 
all 


(a5 Delay 

comf PORTB , W 
andlw _b'11110000' 
btfss STATUS , Z 
goto GetRow 


bsf PORTA , 1 

bcf PORTA , 2 ;Address col 3 
movlw 0x08 

movwf Kbdcode 

call Delay 

comf PORTB , W 

andlw  b'11110000' 

btfss STATUS 2 


goto GetRow 
bsf PORTA , 2 
bcf PORTA , 3 ;Address col 4 


movilw Ox0C 

movwf Kbdcode 

call Delay 

comf PORTB , W 
andIlw = b'11110000' 
btfss STATUS Sz 


goto GetRow 
bsf PORTA , 4 ;Kill Strobe as no key pressed 
moviw  b'00010000' ;Set columns all low so any key press 2 
movwf PORTA : will awaken from sleep 
bcf INTCON , RBIF ;Clear port B change flag 
sleep 
nop ;wake up to here if key pressed 
goto MainLoop 
GetRow ;Enter with Bits 2/3 of Kbdcode showing Col count 
call Delay ;10ms Debounce delay 
call Delay 
call Delay 
call Delay 
call Delay 
call ‘Delay 
call Delay 
call Delay 
cal] Delay 
call Delay 


btfsc PORTB , 4 

goto Row2 

mov Iw 0 

addwf  Kbdcode 

goto RowOk 

| Row2 

: btfsc  PORTB , 5 
goto Row3 
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Table 7.1 (continued) 


movilw = 1 
addwf  kKbdCode 
goto RowOk 


: 
: 
i 
Row3 
btfsc  PORTB , 6 
goto Row4 
movlw 2 
; addwf Kbdcode 
goto RowOk 
| Row4 ;must therefore be column 4 
| mov lw 3 
‘ addwf  kbdcode 
| Row0k 
| . movf Kbdcode , W 
subwf LastKey , W 
BUPSe Gee STATUS: aUZ ;if last two reading are equal, valid press 
i goto KeyOk 
i movf Kbdcode , W 
movwf LastKey ;save key for check next time 
goto MainLoop 
' KeyOk ;Kbdcode contains a valid col/row number 
movf Kbdcode , Ww 
call Table 
i movwf Temp 
bcf STATUS , C 
' movf Temp , W ;Put BCD Output to 4 LSBs of PORTB 
movwf  PORTB 
sleag PORTA , 4 ;Strobe after valid check 
call LongDelay sinhibit another key for 500ms 
goto MainLoop 
Delay 
movlw d'‘21' ;delay = 5N+9 = Ims 
movwf DelCount 
_ DelLoop 
i nop 
nop 
decfsz DelCount 
goto DelLoop 
nop 
nop 
| nop 
nop 
return 
LongDe lay 


| 

| movlw d‘'250' 

| movwf Counter 

| LongDelLoop 

; call Delay ;500 calls to delay 
call Delay 
decfsz Counter 

goto LongDelLoop 
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Table 7.1 (continued) 


return 
Table ;3x4 keyboard, KdbCcode format OOO00CCRR 
addwf = =PCL ;Valid for codes 0 to 254 
retlw 1 sRow 1 , Col 1 
retlw 4 
retlw 7 ; ;table for 3x4 keypad 
retlw  Ox0A a 
retlw 2 
retlw 5 
retlw 8 
retlw 0 = 
retlw 3 
retlw 6 
retlw 9 
retlw 0x0B ;# 
retlw Ox0C > Col 4 not always implemented 


retlw  Ox0D ; 
: retlw  Ox0E 5 
| Tend retlw Ox0F ; 


if (( Table & OxFF) >= (Tend & OxFF)) 
MESSG "Warning, table crosses page boundary" 
endif 


if (Table >= 0x100) 
MESSG "WARNING Table start above 0x100, ensure PCLATH is set" 
endif 


consumption is kept low enough to give hundreds of hours operation from 
the battery in the hand-held unit. 


Filter selection 


This unit is designed to automatically switch relays that select the low-pass 
- filters at the output of an HF PA. Most HF power amplifiers are broad-band 
devices, covering at least 2 to 30MHz, but harmonic filters have to be se- 
lected depending on the frequency of operation — usually there are five or 
six low-pass filter elements with sub-octave frequency cut-offs. If the PA is 
_ designed to be no-tune in its operation then it is a pity to spoil this ‘transpar- 
ency’ by having to manually select the low-pass filter to use. The solution 
usually adopted is to let the transceiver ‘tell’ the PA which band it is on by 
sending a tuning voltage, but why not just measure the transmitted fre- 
quency and set the filters accordingly? 
The circuit is shown in Fig 7.2 and works as fellows A portion of the RF 
signal is converted to a logic level and its frequency is divided by four in a 
pair of flip-flops. Then it is applied to the PIC counter-timer input. The PIC 
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timer is configured to rapidly measure the frequency and then, by making 
use of a small look-up table, choose which one of the output ports to acti- 
vate, which in turn switches into circuit the appropriate low-pass filer. In 
fact the external prescaler is not really necessary as the 16F84 internal 
prescaler will operate with up to 5|0MHz input; this snippet of useful infor- 
mation was not known at the time of designing the project, hence the pair 
of flip-flops! 

With typically six filters that can be switched, it is not necessary to meas- 
ure the frequency very accurately — all that is really required is to be able to 
measure the frequency to something like the nearest megahertz. With an 
eight-bit counter in the PIC, an upper operating frequency limit of 30MHz 
means a frequency resolution on 30/256 = 117kHz can be achieved. Here 
a gate time of 250ps is employed, coupled with a total of 32 times prescaling 
of the RF. This frequency division is made up from four in the external 
divider and another divide by eight within the PIC. So the actual frequency 
measurement resolution is 1/250ps x 32 = 128kHz. The complete software 
listing is given in Table 7.2. The frequency is continuously measured in the 
MainLoop part of the programme, and converted to a frequency ‘number’ 
based on the boundary values defined at the beginning of the programme. 
Here only six possible values are used, hence the five boundary values 
defined as F1 to F5. The FO value is a frequency threshold below which any 
measurement is deemed to be ‘no signal present’. Every time a frequency 
number is obtained, it is compared with the previous two readings, and 


To relays 


Fig 7.2. HF PA auto- 
matic relay selector 
circuit diagram 
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ae FILTSW1A.ASM Measures Tx frequency /4 via timer, based on 4 MHz PIC 
= clock and sends code to Port B for driving normal relays 


: Bit 0 - lowest frequency etc. 


;Filter 


| ints 


startup 


MainLoop 
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LIST P=16F84 
INCLUDE “P16F84.INC" 
LastSet equ 
ThisFreq equ 
Temp equ 
PortTemp equ 
DelReg equ 
Freq equ 
DelReg2 equ 
lower boundaries (units 
FO equ 
Fl equ 
F2 equ 
F3 equ 
F4 equ 
F5 equ 
GateConst equ 
org 0 

nop 

clrw 

movwf INTCON 

goto startup 
retfie 

clrwdt 

bsf STATUS, RPO 
moviw  b‘11100010' 
movwf OPTION_REG 
movlw  b'00010000' 
movwf PORTA 
moviw  b‘00000000' 
movwf  PORTB 

bcf STATUS, RPO 
movlw  b‘'00100000' 
movwf  PORTB 

call GetFreq 
movwf Freq 

btfser “SHATUS £z 
goto MainLoop 
call GetFreq 
subwf Freq , W 
btfss * {STATUS ©. z 
goto MainLoop 


call 


Table 7.2. Complete software listing for automatic HF PA filter switching 


GetFreq 


;Three identical measurements, its probably 


0x0D ;Holds current freq code/relay state 
OxOE ;Temp latest frequency measurement 
OXOF 

0x10 ;Temp working register for Port B 
0x11 

0x12 ;Current frequency code measurement 
0x13 ;needed for relay pulse delay 

of 128 kHz, max freq > 32.6 MHz overflows) 
d‘'11" 51.41 MHz Test frequency for no signal 
Gas 2 oh SP Maz 

d" 31" 33.97) MHz 

d'58"" 37.42 MHz 

d'117" 514.98 muHz 

d'172' 322.02 MHz 

d'49' ;delay constant for counter gate = 250us 


;disable interrupts 
;jump to main code 
;interrupt service routine code 


;ram page 1 
;External input, Prescalar /8 


; 
;A4 as input for Fin, rest as outputs 
;Port B as outputs for relay drivers 


;ram page 0 

;start with highest freq as default 
;Frequency CODE used throughout 
;Frequencies coded as 0 - 6 represented 
;as boundaries for relays 

;Check for no signal 


;measure again 


;if not the same forget it 
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Table 7.2 (continued) 


| 


: subwf Freq , w ;the correct value by now 

Btiss.. STATUS. , Z 

goto MainLoop 

| 

movf Freq , w 

i subwf LastSet , w ;Has it changed from last time ? 

btfsc. STATUS , Z 

goto MainLoop 

: movt Freq , w 

| movwf LastSet ;Update the current frequency 

moviw 1 

movwf  PortTemp 

i ; bcf STATUS 2. wc ;make sure 1 doesn't get shifted in 

PortLoop 

' decfsz Freq ; lowest freq is 00000001 

goto shift 

movf PortTemp , w 

i movwf = PORTB 

goto MainLoop 

| shift 

obi ing PortTemp ;move 1 to left, Freq number of times 

} goto PortLoop 

| GetFreq 

CLEL ThisFreq ;Local variable for frequency code 
erin TMRO 

movlw GateConst 

movwf  DelReg 

nop 

nop 

nop 

GateLoop ;delay between TMR set and read = 

nop 55N + 5 
nop 


decfsz DelReg 
goto GateLoop 
movt TMRO , w 


movwf Temp ; 
sublw FO : 
btfss . STATUS 4: ¢ 

incf ThisFreq 
’ 


movf Temp , w ;Temp contains gated count 
i sublw Fl ;test for >Fl, w= Fl - WwW, If -ve then c=0 
btfss STATUS EEC ;means greater than Fl, so inc. Freq Code 


incf ThisFreq 


movf Temp , w ;each time > threshold, incr ThisFreq value 
| sublw F2 

i betss'= “STATUS | C 

incf ThisFreq 

movf Temp , w 
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Table 7.2 (continued) 


sub lw F3 

btfss STATUS ian © 
incf ThisFreq 
movf Temp , w 


sublw F4 

btfss STATUS~,."C€ 
incf ThisFreq 
movf Temp , w 


sublw F5 
btfss STATUS: 7G 
incf ThisFreq 


movf ThisFreq , w 
return ;Returns frequency code in W 


only if three consecutive identical readings are obtained is it considered to 
be a perfect result. Making use of three readings in this way ensures there 
will be no spurious switching if a frequency measurement error occurs, due 
to a low RF level for example. The valid frequency number is then com- 
pared with the current value and, if these are different, the new code is sent 
to the relay driver port. Since there is no shortage of ports available on the 
PIC for this project a serial driver chip such as the UCN5841 is not neces- 
sary and cost is saved by using simple transistor drivers for the relay inter- 
facing. 


PicATUne automatic antenna tuner 


The PicATUne, designed by Peter Rhodes, G3XJP, was originally described 
in RadCom [1], and contains some novel ideas to simplify design and reduce 
costs. Here we limit the description to a brief outline of the tuning algo- 
rithm and PIC software. Fig 7.3 shows a block diagram of the PicATUne 
~ concept from which it can be seen that the critical components are a SWR 
detector head and a bank of relay switched inductors and capacitors mak- 
ing up the antenna tuning assembly. Fig 7.4 shows the complete circuit 
diagram of the logic board. The PIC first measures the frequency and looks 
in memory to see if a match for this frequency already exists. If it does, 
these values are set and tested for a low SWR reading. If no values exist, or _ 
the SWR is too high due to a changed antenna, for example, the PIC soft- 
ware attempts to find a new match. It does this by measuring the reflected 
signal level, presented as a DC voltage from the SWR detector head, and 
then making a change to the L or C values. The change in reflected signal is 
measured again to determine if the result is better or worse than before. 
The PIC software is thus simulating an operator adjusting a manual ATU 
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by reference to a SWR bridge. A more 
comprehensive description of the tun- 
ing algorithm is given in reference [1]. 

Once a match has been obtained the 
frequency is measured by the PIC coun- 
ter/timer and the L/C settings are stored 
in non-volatile EEPROM memory for 
future access. A novel trick adopted in 
this design is the measurement of an ana- 
logue voltage without the cost of includ- 
ing an A/D converter chip. The RA3 pin 
is normally set as an input. When a re- 
flected power measurement is required, 
RAS is changed to an output pin, pulsed 
high and immediately reconfigured as 
an input pin. The time taken for RA3 to 
fall below the ‘1’ threshold is then de- 
termined, giving a measure of the volt- 
age across C48. The width of the high 
pulse is adjusted with the cal relay ener- 
gised — and therefore no reflected power 
— to calibrate the zero point. The proc- 
ess is crude but effective, given only that 
the requirement is to determine the di- 
rection of change as the L and C values 
are altered. 

A serial input shift register allows the 
large number of relay drive lines to be 
controlled by making use of just three 
PIC outputs, and separate driver tran- 
sistors are used instead of a dedicated 
serial relay driver as this actually saves 
PC board space. 

The final part of note is the frequency 
measurement routine. The system de- 
scribed in the previous section for filter 
selection is not adequate here as a higher 
frequency measurement resolution is 
needed and a clever workaround is em- 


ployed to enable the contents of the internal prescaler, set to divide by its 
maximum possible of 256, to be read. Normally these lowest eight bits of the 
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count, which cannot be read out in software, would be lost in the frequency 
measurement process, reducing accuracy to below that needed. To count RF 
cycles both RB4 and RA4 are set as inputs for the counting gate time — in this 
case 400ps. At the end of the gate period, RB4 is changed to an output pin 
to freeze the count — this is then toggled high/low until the main counter 
register changes, at which point the prescaler finally overflows. Knowing 
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how many times RB4 was toggled, the value of the eight most-significant bits 
in the main counter, as well as the eight least-significant bits in its prescaler 
are determined, giving a full 16-bit count subject to an error of +1 count, or 
2.5kHz. 


GPS-locked frequency stabiliser 


This low-cost, GPS-locked frequency source is designed specifically for low- 
data-rate signalling on the LF bands. Phase noise and short-term frequency 
stability preclude its general use at HF or above; for these frequencies other 
more conventional frequency standards are preferable, based around crys- 
tal oscillators of inherently higher stability. 

A conventional synthesiser or phase-locked loop (PLL) approach is im- 
practical for locking a frequency source to the 1 pulse per second (pps) 
signal from a GPS receiver. The only reference frequency is at 1Hz so a 
PLL would need to have a bandwidth considerably less than this, meaning 
that the loop would only lock up after many tens of minutes or hours. Fur- 
thermore, the stability of the basic oscillator element — the voltage-control- 
led oscillator or (VCO) - would have to be such that it did not drift by more 
than 1Hz during a time comparable with the loop bandwidth, otherwise 
lock could never be achieved. A high-stability VCO is needed and, for a 
design operating at a few megahertz, the required stability would be less 
than | part per million (ppm). Voltage-controlled crystal oscillators (VCXOs) 
to this accuracy, also usually temperature controlled, are available but are 
expensive and only occasionally appear on the second-hand surplus mar- 
ket as part of test equipment. Brooks Sheera, W5OJM, has designed an 
excellent GPS-locked high-stability frequency source using such an oscilla- 
tor, which was described in QSTJuly 1998. This does require several hours 
to achieve lock-up and is the sort of precision test equipment that should be 
left running continuously and not be turned off every day. 

However, where short-term stability is of less importance, another tech- 
nique can be used. The source described here is based roughly on the old 
Huff and Puff stabiliser, first described by Klaus Spaargen, PAOKSB, in 
1973. This design stabilised a ‘good’ LC-tuned VCO to give it crystal oscil- 
lator stability, in steps of 10Hz. In essence, the design used a 1-bit frequency 
counter — a single flip-flop clocked by pulses divided down to 10Hz from a 
crystal oscillator. Depending on whether the VCO frequency was high or 
low of the appropriate 10Hz step, the output of the flip-flop ends up ata 1 
or 0 and is applied via a low-pass filter to a variable-capacitance tuning 
diode on the LC oscillator, which is ramped up or down to maintain the 
long-term frequency. The output would then be continuously hunting just 
above or just below the nearest 10Hz step. 

The problem with this design was that if the LC oscillator drifted by 
more than one step, eg 10Hz, the locked frequency would therefore slowly 
move in jumps of 10Hz. There were numerous improvements to the origi- 
nal design in the following years, several adding more bits and resolution to 
the frequency counter, allowing a higher inherent drift, but the Huff and 
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Puff gradually died out as frequency synthesisers took over. Synthesisers all 
rely on phase locking a VCO to a master reference, usually at a reference 
frequency of a few kilohertz, so consequently the PLL can lock up quickly 
and short-term stability is not an issue — long-term stability is then purely a 
function of the reference which can be made as good as is wanted. 


Circuit description 

This design applies the Huff and Puff technique to a simple VCXO without 
a crystal oven to maintain a source frequency that hunts either side of a 
specified 1Hz multiple, but uses an extended eight-bit frequency counter to 
avoid the possibility of the locked frequency drifting in jumps of 1Hz. The 
VCXO operates at 4.194304MHz (2”Hz) for reasons that will be described 
later, but any frequency that is a multiple of 1Hz may be employed. It is 
also easier to understand the concept if a frequency that is an exact multiple 
of 256Hz is initially chosen. Refer to the circuit diagram, Fig 7.5. 

A straightforward crystal oscillator is built with CMOS gates, with a vari- 
able-capacitance diode connected across the crystal to shift its frequency 
either side of nominal by a few tens of hertz. Choose the diode and cou- 
pling capacitors to ensure that it is not possible to pull the frequency more 
than 128Hz over the full input voltage swing of 0-5V. This oscillator drives 
a synchronous eight-bit counter made from a pair of 74HC161 chips, the 
eight outputs from which are connected to a 74HC374, eight-bit D-type 
latch. This is triggered by the rising edge of the 1 pps signal from a GPS 
receiver so that each second the output of the latch contains the lowest 
significant eight bits of the count. This counter overflows many times for 
each counting interval, but for any frequency that is an exact multiple of 
256Hz, the counter will overflow to the same point each time, and the count 
latched by each seconds pulse will then be a constant number. If the fre- 
quency is not a multiple of 256Hz, but is still an exact 1Hz multiple, the 
count will change from one second to the next in a predictable manner. For 
example, a 5MHz signal would give successive counts (assuming a start at 
zero) of 00, 64, 128, 192 before the sequence repeats, which is completely 
predictable. However, for this description we will continue with a frequency 
that is a multiple of 256Hz so the ideal count stays a constant. If the fre- 
quency departs slightly from its correct value, the residual count will stead- 
ily increase or decrease by the magnitude of the frequency error and, if not 
corrected, the counter will eventually wrap round. 

What we now do is to read the count every second, then drive a charge 
pump circuit in a direction such as to correct the frequency. Software in a 
16F84 PIC processor, using the trigger pulse from the GPS, reads the latched 
counter value and calculates an error value from the expected count every 
second. For multiples of 256Hz this merely involves subtracting a constant, 
which can conveniently be a value of 128 — half the counter length. If other 
frequencies are wanted, the ‘correct’ value will increment by the frequency 
modulo 256, every second. The sign and magnitude of the error value ob- 
tained is then a measure of the phase, and hence frequency, error and is 
used as follows. 
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Port A3 on the PIC is normally maintained at a high impedance by setting 
it as an input. Every second, except for the single case where the error value 
is zero, this port is set as an output and strobed high or low, depending on 
the sign of the frequency/phase error. The duration of the strobe pulse is 
proportional to the magnitude of the error so that an error count of 128 leads 
to a strobe pulse of 0.64 seconds, either high or low, down to the minimum 
resolution of 5ms for an error count of one. This strobe pulse is then taken 
via an RC network to drive the variable-capacitance diode on the VCXO. 
The RC constants were determined by a combination of experience, trial 
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Fig 7.5. GPS-locked 
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circuit diagram 
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and error, serendipity and luck to give an acceptable compromise between 
lock-up time, chirp and pull-in range. To assist lock-up, after turn-on the PIC 
software applies a precise square wave to the charge pump for 20 seconds, 
to force the capacitor to mid-voltage and near to the nominal operating 
frequency. The loop then only has to make minor corrections to get the 
correct frequency and phase (the counter mid-point). The use ofa three-state, 
high-impedance port which is only briefly pulled high or low considerably 
reduces the residual chirp over that of a continuously changing low- 
impedance connection, as in the original PAOKSB concept. 

As an additional aid to debugging, the error value is output from the PIC 
as an RS232 signal at 1200 baud. The format is a decimal number ranging 
from -128 to 127, followed by a space, for display on a standard ASCII 
terminal. 


Performance 
With the RC values and variable-capacitance diode specified, after the 20s 
initialisation period the loop was fully stabilised after running for about two 
minutes. The frequency as measured on a counter was exact, when using a 
10s counter gating time. By monitoring the output on a vectorscope refer- 
enced to a high-stability source, every second, on average, the phase would 
rapidly rotate by a value between 180 to 500° (0.5 to 1.5 cycles) then return 
more slowly. This appeared as a slight audible chirp of a few hertz. How- 
ever, the mean phase stays constant, ie the vectorscope always averages out 
the clockwise and anti-clockwise rotations to zero. The error value trans- 
mitted from the RS232 port usually stabilised at a small positive number 
rather than zero. The reason for this is not clear, but may be due to leakage 
around the charge pump circuitry, or rectification of the RF in the diode, 
causing a constant offset. Its effect does not appear to be important to op- 
eration. Without programming in the 20s initialisation period, there were 
times, depending on the initial random starting count, when the loop would 
fail to lock up at all, and other times when lock would occur after a few 
minutes. 

By using the output as a clock for an AD9850 DDS chip, the output 
frequency is divided down and the phase blip is reduced by the same pro- 
portion. At 137kHz, for example, the 360° blip at 4MHz appears as a blip 
of 11° every second, always returning to the same value. When averaged 
out over a 30s signalling element the net phase shift is very close to zero. 

A LED flashes with the 1 pps signal, and the duration of flash is related to 
the width of the charge pump pulse. Therefore, when locked the LED gives 
a short flash but, during the lock-up phase, the flash is of varying duration 
and, if the GPS pulse is not present, the LED does not flash at all. 


Construction and setting up 

The circuit layout is not critical, apart from that around the VCXO. Here, 
wires need to be as short as possible and the loop filter components need to 
be mounted close to the variable-capacitance diode to avoid picking up 
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interference which is then cou- 
pled onto the output signal. A 
double-sided PCB is illustrated 
which makes use of normal 
2.54mm pitch DIL ICs, but sur- 
face mount resistors and capaci- 
tors. The layout is given in Fig 
Zee 

There is a certain amount of 
initialisation of the circuit neces- 
sary before satisfactory opera- 
tion can be guaranteed. Firstly, 
the VCXO has to be set to the 
correct frequency. Before solder- 
ing in the RC loop filter compo- 
nents, connect a potentiometer 
to the variable-capacitance di- 
ode decoupling resistor, shown 
as TP1 on the diagram. Set to 
mid-rail at 2.5V and adjust the 
preset capacitor for a frequency 
as close as possible to the correct 
value. Swing the tuning voltage 
over the range 0-5V and ensure 
that the output frequency shifts 
by no more than about 100Hz in 
either direction. Much more than 
this, and a false lock 256Hz away 
is theoretically possible ifthe crys- 
tal drifts over time; much less 
that this, lock-up time and drift 
may be a problem. To change 
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the correct value if the setting-up procedure was followed carefully. After 
this time has elapsed, the LED will start to flash in synchronism with the 
GPS pulses, the flash duration appearing to vary in an apparently random 
manner. If the counter error value is being monitored, it will also show a 
rapidly varying number each second but, after about 30—60s, a pattern will 
start to emerge and the value will gradually converge to a constant value, 
not far removed from zero; the duration of the LED flashes will also shorten. 
The voltage at TP1 should now be stable, and after a few minutes the loop 
should have stabilised, at which point the output frequency is locked. If you 
listen to this signal on an SSB receiver, it should give a slight blip every 
second which should be just about audible, but how much depends on how 
musical your ears are! 

There is plenty of scope for further experimentation, particularly around 
the loop, to decrease chirp/phase blips and improve lock-up times. One 
idea that would be worth investigating would be to have a non-linear rela- 
tionship between error value and pulse width. This is something that is 
straightforward to implement in software but complex in a PLL built com- 
pletely in hardware. 


PIC software 


The PIC software STABILO1 is available from the RSGB website under 
that name. An enhanced version STABILO2 is also available with several 
minor improvements. Detailed operation of the software can be seen by 
examining the source code in the .ASM files. 

¥ 


Known problems 


1. The loop error value is rarely stabilised at exactly zero during operation. 
This is probably caused by rectification of the RF in the VCXO by the 
variable-capacitance diode, which the loop has to fight. It could be cured 
by adding an op-amp buffer to isolate the diode drive from the loop filter 
itself, but the effect does not appear to cause a problem so no buffer has 
been included. Increasing the value of the 390k resistor feeding the 
diode reduces this effect, but this shouldn’t be made too high as spurious 
pick-up could then become more of a problem. Charge pump capacitor 
leakage will show the same effect if any is present, and is particularly 
noticeable at any time a voltmeter is connected to TP1. 

2. The latching of the counter by the GPS pulse is asynchronous to the 
counter increment, so there is a probability (a certainty in fact) that at 
some point the reading will try to be latched at the very instant it is 
changing; minimising this, in fact, was the reason for using a synchro- 
nous counter here. The only way to prevent the situation from occurring 
at all would be to add some gating or second-level buffering to the latch, 
which would be horribly complicated for a simple design such as this. 
Fortunately there is a simple work-around. During testing it was observed 
that a read like this always appeared to result in a latched value of all 
ones. The software detects this condition and ignores that particular value, 
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treating it as if a value of 128 had been read instead and issuing no pulse. _ Fig7.7.GPSclockcir- 
The loop can never be so stable that this glitch situation will occur re- ‘¥#t diagram 
peatedly, and the tracking continues uninterrupted at the next pulse. The 

resultant 2s delay may cause a slightly larger blip than usual, but this 

should not be unacceptable in practice 


Automatically set GPS clock 


This PIC-based design also interfaces to a GPS module and makes use of 
the 1 pps signal and the serial NMEA output, using the data contained in 
the NMEA message to automatically set a clock. The NMEA sentence struc- 
ture was illustrated in Chapter 3, and the GPRMC sentence is used here as 
it contains both time and date information. A display of either data or time 
is made on a six-digit LED display which is operated in a multiplexed de- 
sign as described in Chapter 4. 

The circuit diagram is shown in Fig 7.7 which shows how separate digit- 
driver and seven-segment decoder-driver chips are used to free up sufficient 
PIC I/O lines. The NMEA output from the GPS module is connected 
directly to the PIC; the Garmin GPS25 module gives simultaneous outputs 
of both TTL and RS232 level signals. We make use of the former here, so the 
polarity of the RS232 interface is opposite from that in most of the designs 
in this book and can be connected directly to the PIC input. Some GPS 
modules only support true RS232 levels and these will require a series 
resistor of around 5.6kQ to avoid overdriving the input port, with a 
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modification to the software to invert the polarity. Alternatively a separate 
single transistor or logic gate inverter could be included. 

The complete software is contained in the file GPSCLOCK available 
from reference [1] but a basic description follows. During normal operation 
the software sits in a loop, multiplexing data stored in the hours/minutes 
and seconds registers to each of the six digits in the display in turn. During 
this period it is also monitoring the user switches for display of date rather 
than time, or, if requested, re-syncing to the NMEA sequence. This is rarely 
if ever necessary but has been included ‘just in case’. The GPS 1| pps input 
causes the software to jump to the interrupt routine which progressively 
increments the seconds counter then tests for rollover to the next minute, 
hour etc right the way through to the year storage register. Leap year cor- 
rection is included using the four-year rule, but no more — it will fail in the 
years 2100, 2200 and 2300 but is unlikely to be a problem, and can be 
solved just by pressing the re-sync button which will allow correct opera- 
tion for another hundred years. This piece of software was written during 
the last months of 1999 and tested when it successfully showed the exact 
start of the new millennium. 

At switch on, the 1 pps update interrupt is disabled and the software has 
to get the correct time from the NMEA message. It does this by receiving 
all characters appearing in the NMEA message and pushing them onto a 
stack, ensuring the last six are always available. The stack is continuously 
checked for the header ‘$GPRMC’ and, when this text appears, the pro- 
gramme starts looking for the commas that delimit the message param- 
eters. The commas are counted and as soon as this count reaches two, we 
know that the data just preceding it was the time of the last pulse in 
HHMMSS format, and that this information was saved to a known position 
on the stack, ready to be transferred into the time-holding registers. Receipt 
of the 10th comma indicates that the date, also six digits, has just been sent 
and this can be transferred similarly. Once the correct date and time have 
been read into the counter registers, a flag is set to indicate data validity, the 
PPS interrupt is enabled, and software control proceeds to the main display 
multiplexing loop with the interrupt routine updating the date and time. By 
testing for other comma counts the position of the observer could be ex- 
tracted, but the stack size would then have to be increased and the display 
altered to accept the increased number of digits required. 


Converting code for the 16F628 


Many of the PIC programmes described so far are targeted at the 16F84 
device. This, with its Flash memory and EEPROM non-volatile data stor- 
age, make it one of the most useful chips in the family for general-purpose 
use, and it has become the standard ‘workhorse’. However, a newer device, 
the 16F628, has now appeared on the scene and is set to become the new 
workhorse — and furthermore it is slightly cheaper than the 16F84. Its ad- 
vantages over the 16F84 are greater programme memory, 2048 words in- 
stead of 1024; increased data memory with 224 bytes of internal RAM and 
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| Table 7.3. Example set-up code for the PIC16F628, showing some of the variations from that 


for the 16F84 device 


config 0x3F63 ;LV Programming off , OSC EC Mode (RA6 I/O) 
I> INITIALISATION ; | 
cirf PORTA ;Special set-up to disable comparator on 16F628 


) 
movlw 7 | 
movwf = CMCON / 

| 


| GetEE ;different from 16F84 EE registers all in bank 1 now | 


bsf STATUS, RPO sram page 1 | 

movwf = EEADR | 

bsf EECON1 , RD 

movf EEDATA , W | 

bcf STATUS , RPO s;ram page 0 

return 
Bias 


128 bytes of EEPROM. Additional hardware includes a synchronous/asyn- 
chronous receiver transmitter (USART), extended counter timer functions 
and voltage comparator module. It is also possible, when using an external 
clock, to get access to another I/O connection on PORTA. A low-voltage 
programming mode is available to allow in-circuit reprogramming without 
having to connect a separate programmer to generate a high programming 
voltage — the existing 5V levels can be used. 

Code written for the 16F84 will run on the 16F628, but a few changes are 
needed to cope with the extra peripherals and their connections to the out- 
side world : 


1. Low-voltage programming has to be set to OFF if port connection B4 is 
to be used — the default is ON, and the appropriate configuration bit has 
to be set. 

2. The voltage comparator is configured as the default, and if this function 
is not needed, the CMCON bits must to be set to disable the comparator 
to gain access to PORTA. 

3. The EEPROM data memory control registers are now all located in Bank1 
— so existing code for accessing these has to be changed. 

4. To get access to PORTA,6, set External Oscillator mode in the configu- 
ration bits. 


An example of set-up code for the 16F628 is shown in Table 7.3. 


The Mini DDS (direct digital synthesis) 


This project was designed by Jesper Conran as an example of what can be 
achieved with the high processing speed and simple instruction set avail- 
able in the AVR processor. The following was extracted from his website 
[2]. : 
“After looking at a design that used an Analog Devices AD9832 DDS 
chip, I came up with a very simple version of the DDS synthesiser, using 
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Fig 7.8. Mini DDS cir- 
cuit diagram 
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just the 2313 and a resistor network. It’s controlled over RS232 from a 
small Windows program, and can generate sine, sawtooth, triangle and 
square waves ranging from 0.07Hz to about 200-300kHz in 0.07Hz steps, 
depending on your crystal. 

“The circuit diagram is shown in Fig 7.8 and is as simple as can be with 
just four major parts — a voltage regulator/switch, an RS232 interface chip, 
the 2313 and the R2R resistor network. The R2R network is connected to 
PORTB on the 2313, making it a simple D/A converter and makes it possi- 
ble to output 256 voltage levels. 

“Neither the resistor network or port drivers of the 2313 is of perfect 
linearity, but it works pretty well anyway. But you’ll probably need a buffer 
stage as the output impedance is rather high (tens of kilohms in my case). 
The MAX603 handles the voltage regulation as well as the power-up/shut- 
down function, and is controlled by the DTR signal on the serial interface. 
So when you shut down the control program on the PC, the Mini DDS will 
be shut down for battery saving. Fig 7.9 shows a picture of the Mini DDS, 
built on a PCB that fits in a TEKO box. 

“The control software user interface is illustrated in Fig 7.10, and this, 
together with the 2313 source code software, is available from reference [2]. 

“The software is written in assembler, as it is very short and it needs the 
speed in the main loop. This is the heart of the synthesiser. The rest of the 
code is the wave tables and the communication code. The phase accumula- 
tor uses 24 bits, which determines the resolution of the output frequency. 
Maximum available frequency and resolution are also dependent on your 
crystal frequency. 
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“The main processing loop of the 
DDS takes up just six instruction 
memory words and executes in 
nine clock cycles. During this time 
the processor: 


(a) adds the 24-bit offset to a 24- 
bit accumulator; 

(b) uses the top byte of the accu- 
mulator to look up the required 
output amplitude from an 
eight-bit look-up table with 
data for sine, triangle, sawtooth 
and square waves; 

(c) outputs the result of the sine ta- 
ble to the R2R ladder output. 


Ata clock speed of 11.06MHz this 

loop executes in just 814ns. 
“Communications with the DDS is achieved by serial communications Fig 7.9. Mini DDS 

using interrupts and based around the built-in UART. One of the compro- P©8 

mises of the design is that the DDS loop 

cannot run when the AVR is processing #- MiniDDS oo is Xx] 

the serial commands. However, this is a 


small price to pay for such a powerful Frequency [123456005959 H> { Com 


and low-cost synthesised signal source. 
“The analogue output from the DDS 9 
is generated by using an R2R ladder con- asad <{<J {>| 2»| nelle 
nected to the AVR’s eight PORT B out- Matavetorn iSine C Com 
; om 


puts. This creates an elementary high- 
speed DAC. Accuracy (and therefore, to 
some extent, spurious DDS outputs) de- Eat _Se | { Com 
pend on the accuracy of the R2R resis- 
tor values. Note that some filtering and 
buffering will almost certainly be required on the output of the R2R ladder _ Fig 7.10. Mini DDs 
but is not shown on the circuit diagram.” CE AG 

A Windows program is available from Jesper which drives the DDS from 
the COM port of a PC. 


Resolution = Fup, = 150994944 and Foy; = Accumulator x Resolution 


Here, with a 11.059200MHz crystal, the resolution is 0.073242188Hz. To 
get an output frequency of 1kHz, we need to use a phase accumulator value 
of 0x003556 (13654 decimal). This gives an output frequency of 
1000.048835Hz — good enough for most hobby work! 

The communication is pretty simple and just allows you to set and read 
the phase accumulator value, as well as selecting the type of output wave- 
form. It uses a 32-bit value for the phase accumulator to be compatible with 
the larger DDS circuit using the AD9832 chip. 
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Digital signal processing 


Basics of DSP 
Digital signal processing (DSP) is the technique of taking a signal, usually 


an analogue waveform, and performing mathematical operations such as 
addition and multiplication on a series of digitised samples. Many of the 
tasks that are performed by DSP would traditionally have been done in the 
past by analogue means with operations that might typically involve fre- 
quency conversion, filtering and demodulation — all of which occur in a 
conventional communications receiver. Modems for data modes are these 
days nearly always implemented in DSP, although analogue designs may 
have been used in the past for modes such as radio teletype (RTTY). The 
ST5 RTTY terminal unit was a classic example in its day of a modem con- 
structed using analogue techniques. 

A number of other specialised techniques have become available in DSP 
that were hitherto impossible to visualise. The classic example here is the 
fast Fourier transform (FFT) which will be covered later in this chapter. Its 
analogue equivalent can be roughly approximated by visualising a huge 
bank of hundreds, or thousands, of very narrow band-pass filters side by 
side in the frequency domain, starting at DC and going up to the highest 
frequency present, with an amplitude detector then sitting on the output of 
each filter. In the ’sixties the UK Foreign Office invented a data mode called 
Piccolo which transmitted one of 32 audio frequencies, each corresponding 
to a letter of the alphabet or symbol. The tones were decoded by making 
use of narrow high-Q filters made from resonating reeds and this, along 
with similar copy-cat multilevel FSK systems, is probably one of the few 
analogue implementations of what is now a very simple task in DSP. 


Sampling 

Obviously the first requirement is to turn the continuously varying input 
signal into a series of digital values that can be processed. We met A/D 
converters in an earlier chapter and some of these are perfectly suitable for 
DSP use; generally we need as high a frequency response as possible, cou- 
pled with the maximum resolution or dynamic range that can be achieved. 
What is possible with state-of-the-art (or perhaps more important to the 
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radio amateur, low-cost) devices necessarily involves a trade-off in one or 
both of these areas, but technology and commercial interests are rapidly 
pushing forward the performance of A/D converters so that devices are 
available now for a few pounds that would have cost many thousands of 
pounds only a few years ago. 

For sampling audio, and even low radio frequencies such as up to 25kHz, 
there is a wide range of custom converters in existence designed specifically 
for DSP uses. They include both A/D 

. . and D/A converters with selectable sam- 

they wer epaleel tate ees pling parameters as described below. 

of Fs to appear in the band DC to Fs/2 These devices are usually called CODECS, 

and are designed to interface directly to 

a microprocessor bus or custom serial 
interface. 


cee The first hurdle to overcome when sam- 


Baseband pling a signal is the Nyquist criterion. 
Banna ts Nyquist, a mathematician, proved theo- 
retically that it is possible to perfectly 

Fig 8.2. Spectrum sample a signal provided that the sampling rate (number of samples per 
siete due to second) is at least twice the highest signal frequency present in the input 
waveform. Fig 8.1 illustrates the sampling of a swept sinusoidal signal and 

shows what happens as the frequency of the sampling waveform goes above 

half the sampling rate. The sampled waveform, shown by the dots, appears 

to reduce again in frequency. This critical value of half the sampling rate is 

the Nyquist frequency, above which any input signal will be folded back into 

the fundamental band. This process is called aliasing, and in fact a whole 

band of frequencies either side of each of the harmonics of the sampling 

waveform will all be mapped to the wanted frequency range as illustrated 

in Fig 8.2. So it is clear that a// components above half the sampling rate 

have to be cut out by an anti-aliasing filter before digitisation in the A/D 

converter. The anti-alias filter is usually of an analogue type, although 

switched capacitor designs are often used. If this latter solution is chosen, 

care is needed to ensure high-frequency switching signals do not leak into 


| Sampling 3Fs Frequency Nyquist 


150 


CHAPTER 8: DIGITAL SIGNAL PROCESSING 


the A/D converter input and themselves cause alias products which would 
appear as unwanted carriers or tones. 


Harmonic, or band-pass, sampling 

Note that the Nyquist limit refers to the bandwidth, or information content, 
of the signal and not its absolute frequency. Looking at Fig 8.2 we see that 
it is quite permissible to sample a band-pass filtered waveform that encom- 
passes one of the alias bands rather than the fundamental — for example 
one occupying a band 6kHz either side of an IF of 455kHz - at a rate that is 
dependent only on the bandwidth. If this is done then the A/D converter 
has to be physically capable of operating at the high frequency so that it can 
handle the waveform through its sample-and-hold circuitry. The overall 
effect is to mix down the actual input frequency by behaving as a ‘pseudo’ 
local oscillator at the nearest harmonic of the sample rate that will give a 
mixer product below the Nyquist limit. So now the actual sampling fre- 
quency has to be chosen carefully to ensure the same harmonic is used for 
the entire bandwidth and the converted spectrum does not ‘fold back’ on 
itself. 

The 455kHz example given above, as it has a bandwidth of 12kHz, could 
theoretically be sampled at 24kHz. (We will have to assume that the anti- 
alias band-pass filter before the A/D conversion is perfect, and only signals 
from 449 to 461kHz can possibly be present. Needless to say, in practice 
this is an unrealistic requirement!) If the sampling rate is actually taken to 
be 24kHz then the nearest harmonic to 455kHz of this is the nineteenth 
which has a value of 456kHz — right in the middle of the pass band! So a 
new sampling frequency has to be chosen, remembering that this still must 
be higher than 24kHz. A suitable value might be 1/16 of the lower fre- 
quency limit of the input band, or 449/16 = 28062.5Hz. A more conven- 
ient value close to this can then be tested — such as 28kHz. Now, the lower 
frequency limit is effectively mixed down to 449 — 16 x 28kHz= 1kHz, and 
the upper limit mixes to 13kHz, making use of the same ‘harmonic’. Both 
these limits are 1kHz inside the 0-14kHz allowed, and this can be made use 
of in designing the cut-off band for the anti-alias filter. It now only has to 
produce its full attenuation outside the range 448—462kHz while letting 449- 
461kHz through. 

By now it should have become obvious that the anti-alias filter is a very 
important part of any DSP system. CODECs all include internal anti-alias 
filtering by customised switched capacitor or similar filters. Usually, fre- 
quencies up to 0.45 times Nyquist can be dealt with, and the attenuation 
above 0.5 Fs is below the resolution of the converter. Amplitude ripple in 
the pass band is also very low, and is usually specified in the CODEC’s data 
sheet. Filter performance can sometimes be adjusted by user set-up instruc- 
tions. 


Dynamic range 
The next issue is that of dynamic range, or sampling resolution. All A/D con- 
verters are defined by the number of bits of quantisation they use, and 
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Original Sampled consequently a sampled in- 
signal waveform put waveform can only be 
approximated to a number 
of discrete levels. For an 
eight-bit converter 256 lev- 
els are available, while for a 
16-bit converter this be- 
comes 65,536 levels. Fig 8.3 
illustrates the portions of the 


Tinted portions 5 A 
contribute random quantised waveform contrib- 


errors invsignal uting to the error, and it can 
estimate, and lead 


to added be seen that each individual 


quantisation noise 4 5 : 5 
quantisation point intro- 


duces a random amplitude 
Fig 8.3. Generation error component. The result of adding all these successive quantisation er- 
ae quantisation +or samples is to add a term that looks and behaves in a way identical to 
noise — it is referred to as quantisation noise. The level of quantisation noise 
is linearly related to the number of quantisation levels, leading to a simple 
logarithmic relationship between the number of bits and the amplitude. By 
expressing the amplitude of the quantisation noise in decibels relative to 
the RMS value of a fully sampled sine wave, it is possible to show that the 
signal-to-quantisation-noise ratio is given simply by: 


S/Ng = 6.N- 1.75 dB 


‘This equation only applies for a sinusoidal signal that exactly, fills all the 
quantisation levels, and for typical signals such as voice and modem tones, 
the figure for S/Ng needs to be modified to take into account the peak-to- 
mean (or more correctly peak-to-RMS) ratio of the waveform of interest. 
Uncompressed speech normally has a peak-to-RMS ratio of around 10dB so 
for eight-bit quantisation the absolute maximum signal-to-noise ratio that 
could be achieved after A/D conversion followed by restoration is therefore: 


6 x 8 (bits) — 1.75 — 10dB (peak to mean ) = 36dB (approx) 


The telephone service adopted eight-bit quantisation as a practically realis- 
able number of bits for the network and, as this figure of S/N was not con- 
sidered to be good enough for a toll-quality service, measures had to be 
taken to improve on this value. The solution adopted was to effectively 
compress the speech waveform to reduce the peak-to-mean ratio, raising 
the S/N to around 40dB. Rather than actually adding speech compression 
hardware, a non-linear quantisation was employed which has the same over- 
all effect and allows hardware simplification. Two very similar techniques 
are used worldwide; in Europe and much of the world the quantisation 
equation is referred to as A-law quantisation, in the USA there are slight 
differences and the system is then called -law. Many CODECs for tel- 
ecommunications offer both these quantisation types, as well as linear 
quantisation to different numbers of levels which can be chosen in their 
initial set-up. 
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For radio purposes a signal may already have a considerable amount of 
noise present — particularly when its fundamental signal-to-noise ratio is 
less that that due to the quantisation, so eight-bit conversion can often be 
employed for RF purposes if the highest S/N performance can be sacri- 
ficed. As arule of thumb it is generally accepted that, for extracting signals 
out of noise, the inherent system noise due to RF front-end or antenna 
contributions has to occupy the first three to four quantisation levels of 
whatever degree of quantisation is finally adopted. So higher quantisation 
resolution does mean that signals can be dug further out of the noise, even 
when they are much worse than that due to the quantisation itself. 

One final point that should be noted about quantisation noise is that it 
occupies the entire spectrum from zero hertz to the Nyquist frequency. So, 
if any digitised signal is subsequently filtered to have a narrower band- 
width, with a corresponding reduction in sampling rate (a process called 
decimation that will be covered later) then the quantisation noise is also re- 
duced by this filtering — to below that of the original quantisation noise. In 
fact, it is possible to sample a signal at eight bits at quite a high sampling 
rate, then filter and decimate while expanding to 16-bit quantisation at a 
lower sampling rate purely by mathematical operations. This trick is one 
part of the fundamental design of a software radio; progressively reducing 
the bandwidth and sampling rate to get from a wide RF bandwidth down to 
a single audio channel. 

The signal samples occurring at regular intervals are referred to as time 
domain data, as they represent the waveform over time — in the way an 
oscilloscope shows how a waveform varies over time. The other way of 
representing signals is in the frequency domain, where the horizontal axis 
represents frequency. The corollary to this view of the signal is that shown 
on a spectrum analyser display. We will meet the frequency domain later in 
the section on the FFT process. 


Frequency conversion and the numerically 
controlled oscillator 


So-called ‘frequency mixing’ is actually a multiplication process rather than 
real mixing (which is simply addition of signals). New frequencies are gen- 
erated when two sinusoidal signals are multiplied, and this falls out of the 
trigonometric identities: 


2 x sin (A) x sin (B) = cos (A—B)-cos (A+ B) 
2 x cos (A) x cos (B) = cos (A+B) + cos (A- B) 


or 


2 x cos (A) x sin (B) sin (A + B) — sin (A— B) 
2 x sin (A) x cos (B) = sin (A+ B) + sin (A- B) 
By replacing A and B with terms for signal and local oscillator frequencies, 


the source of the sum and difference mixer products that always occur to- 
gether becomes obvious. Note the relative signs of the two mixer products, 


153 


COMMAND - Computers, Microcontrollers and DSP for the Radio Amateur 


154 


the first is positive, the second is minus depending on whether we use cos.cos 
or sin.sin. This little fact comes into its own later as a method of cancelling 
one sideband, but for a straightforward multiplication of one carrier by 
another in a mixer, any form of the above equations is applicable as phase 
has no meaning when not referred to any particular reference, so the cos or 
sin form is irrelevant and both mixer products will always appear simulta- 
neously. 

All conventional analogue mixers fail to meet this ideal multiplication in 
some way or other, and in most cases a large LO signal has to be used, 
meaning that all its harmonics and all the mixer products of these appear in 
the output waveform and have to be removed by filtering. Possibly the only 
analogue mixer that does act as a real multiplier is the transistor tree (Gil- 
bert cell multiplier) as used in the ubiquitous MC1496 chip and many later- 
generation RF devices such as the NE612. 

In DSP, multiplication can be perfect — it is only a mathematical opera- 
tion after all! So now frequency conversion of a digitised and sampled sig- 
nal becomes that of multiplying each sample value with that of a sampled 
sine wave at the local oscillator frequency. This LO is usually generated in 
a numerically controlled oscillator (NCO) which works as follows. 

Values of sin and cos are generated for the required local oscillator fre- 
quency at the sampling rate of the input signal and exactly synchronised to 
it. The resulting pair of values at each step point is used as the input to the 
multiplication. Actual sin and cos generation is ideal but expensive in terms 
of computation time. So what is usually done is to maintain a table in memory 
with the values for sin and cos for a complete cycle at, say, 1°,intervals. In 
this case there would therefore be 360 pairs of values stored but the 
quantisation of the angle will introduce some phase jitter in the look-up: 
Instead of 360 entries, if we make the table a binary power of two in length, 
(say 256 entries at intervals of 360/256 = 1.40625°), we can see that the 
rollover from 359 back to 360 = 0° will be equivalent to the binary address 
pointing into the table overflowing from the ‘all ones’ state back to zero. 
Many DSP chips have 256-long sine tables built into them 

This is best illustrated by example. In DSP it is standard practice to nor- 
malise all frequencies to the sampling rate, so that this assumes a normal- 
ised frequency of one. The input band up to the Nyquist limit will then 
always occupy values between zero to 0.5, and the LO will likewise fall 
within this range of numbers. This gives a clue as to how the look-up table 
is used. Assume a local oscillator frequency of 0.1 times the sample rate. 
For the very first sample, the first term in the look-up table is taken, which 
for a sine table is zero. Then for the next sample, the address pointing into 
the table is incremented by the normalised LO frequency, so for a table 
that is, for example, 256 samples long the next address would be at 0.1 x 
256 = number 26, the next address 51 and so on. Every time the address 
reaches 256 it wraps round modulo 256 to zero again, simulating the next 
LO cycle. The value of table lengths that are powers of two can now be 
seen — modulo 256 just means truncating all bits of the address higher that 
the eighth. 
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Note that we have now introduced a frequency quantisation term due to 
the rounding of the address, and also the rules of Nyquist apply equally to 
generation of the NCO waveform — no frequencies higher than half the 
sampling rate are allowed. In fact, aliasing is more obvious in frequency 
generation than it is for sampling: any frequency above half the sampling 
rate would necessitate a phase rotation per sample of greater than 180°. 
Any angle greater than 180° is equivalent to a negative rotation of less than 
180° so the net result is a falling frequency as the requested value rises. 

The Nyquist limit is easily designed into (or out of) the system but the 
table length and rounding issues can be a problem. The effect of the fre- 
quency quantisation error is to introduce sidebands onto the pseudo-carrier 
that then appear as added noise — behaving more like phase noise this time. 
Suitable choice of table length can alleviate this, subject to available memory 
limits, but there is another trick of mathematics that can be applied to inter- 
polate the table address to give a much higher resolution — this will be 
covered later where specific DSP routines are described. 


1/Q conversion 
Frequency conversion in DSP can be made much more precise than in 
analogue mixers, and completely removes the need for filtering or removal 
of the unwanted ‘mixer’ product. The technique is to modify the NCO 
routine to generate two outputs per sample point, representing output wave- 
forms 90° out of phase with each other. In other words cos and sin terms 
which we will label cos (A) and sin (A) here. 

Two look-up tables are required for this process, or alternatively a dou- 
ble look-up with addresses corresponding to the 90° difference between sin 
and cos. The two sets of values are each multiplied by the input samples to 


give: 
cos (A) x sin (B) and _ sin (A) x sin (B) 


where A is the numerically controlled oscillator and B corresponds to the 
sampled input signal. 

So far, all we have done for each sampling period is to generate the 
quadrature local oscillator by getting two entries from a look-up table and 
performing two multiplications, but we have now ended up with two values 
from the mixing process, corresponding to 90° phase-shifted terms. These 
are referred to as J/Q samples, which is short for in-phase and quadrature samples. 

Now we come to an even more useful aspect of DSP. These I/Q terms 
taken together completely represent a frequency-shifted version of the in- 
put signal, and the actual frequency shift is irrelevant — it can be anything, 
subject to valid Nyquist values for the frequencies of course. It is perfectly 
reasonable and valid to frequency mix the input waveform with a local 
oscillator that sits in the middle of its pass band. 

For example a sampled voice bandwidth signal of 300-3300Hz can be 
mixed with an LO of 1800Hz to give a ‘folded’ spectrum that goes from 
1800 — 300 = 1500Hz at one extreme, to zero frequency corresponding to 
1800Hz in the middle of the audio spectrum, up to 3300 — 1800 = 1500Hz 
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3000Hz -1500Hz DC +1500Hz 


at the other extreme. On its own this 
is pointless, as now we have mixed 
up the spectral components so they 
overlap each other. But, by virtue of 
having the I/Q pairs of samples, the 
spectrum folding can be eventually 
sorted out and unwrapped. 

Furthermore, the I/Q samples now 
only have half the bandwidth of the 
input signal and range in frequency 
components from DC to exactly half 
the input bandwidth. 

Fig 8.4 shows this I/Q mixing proc- 
ess graphically. An analogue equiva- 
lent to this can be seen in the ‘third 
method’ of SSB generation where a 
0/90° phase-shifted voice signal is 
mixed with a physical 1800Hz local oscillator and low-pass filtered to 
1500Hz, before being subsequently converted up to the wanted carrier fre- 
quency. Accurate matching of all paths was always needed for the third 
method, so this means of generating an SSB signal never achieved popular- 
ity. In the world of DSP nearly all processing is done with I/Q signals since 
these completely represent the entire input waveform. Each of the two val- 
ues are independent and can take on both positive and negative values. 

They can be represented by the vector diagram shown in Fig 8.5. where 
the I term represents the amplitude along the X or horizontal axis, and the 
Q term the amplitude along the Y or vertical axis. Mathematically this is 
referred to as complex notation, where the I component can be likened to the 
‘real’ component of a complex number, and the Q component to the ‘im- 
aginary’ term. There is little need to go into complex notation for describ- 
ing most DSP procedures and that will be the approach taken here, but 
many DSP textbooks can make quite simple techniques seem a lot more 
complicated than they really are by adopting purely mathematical termi- 
nology and explanations. 

This diagram in Fig 8.5 is often referred to as a vectorgram or phasor dia- 
gram. Apart from being a mathematical tool, the vector diagram showing 
I/Q signals can be generated quite easily as a real visual tool by taking the 
I and Q values, and using them to display a spot at the respective X and Y 
positions on a display screen. 

The same result is obtained by converting the I/Q values to analogue in 
a pair of D/A converters and displaying the resulting analogue values on a 
the X-Y display of an oscilloscope after passing through a low-pass filter to 
get rid of the alias terms. 

A signal at exactly zero frequency (derived from a sine-wave input with a 
frequency exactly equal to the local oscillator NCO) appears as a dot on 
this diagram. If the frequency is changed slightly this dot continuously ro- 
tates around the origin, or centre of the chart, with the direction of rotation 


I channel 


Q channel 


Low-pass filter 
to remove sum 
term 2100-4800Hz 
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depending on whether the fre- 


quency is higher or lower than the pppitlys eauency 
(increasing phase) 


reference or centre frequency. The 
I/Q sampling mode of the PIC- 
based DSP interface described in 
Chapter 4 allows a vectorscope to 
be made. This operates at a fixed 
centre frequency of 1000Hz and the 
pattern is formed by plotting dots 
at the X and Y co-ordinates given 
by the I/Q values on a graphics 
screen. 

To complete the description of 
I/Q representation, we need to 
know how to convert it back to un- 
derstandable form. The amplitude 
of the overall waveform is generated 
by using the formula of Pythagoras 
to calculate the amplitude of a pair of vectors at right-angles (the hypot- 
enuse of a right-angled triangle whose other two sides are the I/Q signals): 


A=V(I? + Q?) 


If the values of A are fed to a D/A converter and a loudspeaker we have an 
AM demodulator, with the real audio output derived directly from the down- 
converted I/Q samples. 


The relative phase can be obtained from: 
8 = arctan (Q//) 


but note that the full four-quadrant form of arctan needs to be employed to 
generate a phase value from 0 to 360°. In several high-level languages this 
appears as the ATAN2 function. In DSP chips there are other mathemati- 
cal tricks for obtaining a sufficiently accurate approximation to the arctan 
function without the time-consuming effort of calculating it exactly. In some 
cases it is not always necessary to calculate the phase in order to make use 
of it - one example of this is FM demodulation. 


FM demodulation 


Frequency is defined as the rate of change of phase, so if we continuously 
compare the instantaneous ATAN result with the previous one we can cal- 
culate the rate of change of phase, and hence the frequency. We now have 
a means by which we can demodulate FM from an audio tone (defined by 
the NCO centre frequency) without actually hearing any of that tone itself. 
Such a technique is ideal for slow-scan TV, for example, where we can 
recover a bandwidth of 1350Hz from an FM carrier centred on 1650Hz, in 
an SSB bandwidth of 300-3000Hz, even if the carrier tone swings below 
1350Hz. 


Signal at 
frequency = 0 


Negative 
frequency 


In phase 
axis 


Fig 8.5. Vectorscope 
representation 
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The difficulties with the ATAN function can be resolved for FM demodu- 
lation: instead of actually generating the arctan function then calculating its 
rate of change by comparing samples, the function itself can be differenti- 
ated mathematically —- which gives an exact equation — then the result of the 
mathematical manipulation is incorporated in the calculation of the rate of 
change of phase. The mathematical derivation is beyond the scope of this 
book but results in: 


do/dt = Instantaneous frequency 


= 1. Qia-y + QaAa-n/ Py + Veal 


where J) and Q,,) are the current I and Q samples, and /,,_;) and Q/,_ , are 
the previous samples. With four multiplications and a division, it is clear 
that this is a much easier calculation to perform in real time at high speed, 
and it is usually built into the software of many DSP-based radio receivers. 


Correlation 


Correlation is a term that covers a very wide area of DSP and pervades the 
whole field of signal processing. It basically involves multiplying a signal 
by a reference waveform and then integrating, or averaging, over a number 
of terms. The result is often to extract the wanted signal from noise or inter- 
ference. 

Here we will perform only one of the simplest examples of correlation, 
that of mixing a signal with a sine wave to extract sinusoidal CW-type sig- 
nals from noise. This example will be used to illustrate how DSP software is 
written in a normal programming language. The software can run in any 
high-level language on a PC, even with most 16-bit languages in a DOS 
environment, and is straightforward enough that results can clearly seen 
even if the answers are just printed to the screen! The process involves a 
multiplication of the digitised input signal by sin and cos terms of a numeri- 
cally controlled oscillator, then averaging the results over many terms. An 
A/D converter that can feed digitised audio samples to a PC is first needed, 
and the PIC-based serial A/D converter design of Chapter 4 is ideal for this 
job. This can take a signal received in an SSB bandwidth and send eight-bit 
samples at 10kHz sampling rate to the PC over the serial port operating at 
115200 baud — well within the capability of most PCs within the last dec- 
ade. As an alternative, for programmers who can write for the Windows 
operating system, the sound card can be used as the means to get audio 
samples — an introduction to Windows programming and accessing the 
sound card appears in Chapter 10. 

For the purposes of this section, the software will be written in pseudocode. 
This is a fictional programming language where commands and instruc- 
tions are kept simple and equivalent to those available in all high-level lan- 
guages — so conversion into your language of choice is kept straightfor- 
ward. Apart from setting up arrays, all other bits of set-up and initialisation 
— such as those for serial ports and the display — have been left out as this 
part of the code has no effect on the operation of the routines shown and is 
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Table 8.1. ‘Pseudocode’ listing of a programme to correlate a received signal with a locally 


generated numerically controlled oscillator then integrate over successive samples 


| Dim InputData(1024, 1) ;Set up an array to store 1024 successive I/Q converted A/D samples | 


SampleRate = 10000 ;For the Serial A/D, use 11025 for soundcard etc. 
CentreFrequency = 900 ~~ ;Signal centred on 900 Hz tone 
NormFreq = CentreFrequency / SampleRate 

WaitFor Interrupt 


i 

i 

i 

: 

: 

| SerialInterrupt ;Every new A/D sample that appears causes a jump to this routine 

| N= GetValue 

InputData(HeadPointer , 0) = N * COS(2 * Pi * Phase);write I data into circular buffer 
i InputData(HeadPointer , 1) = N * SIN(2 * Pi * Phase);write Q data into circular buffer 
HeadPointer = (HeadPointer + 1) MOD 1024 ;Update circular buffer pointer 

Phase = FRACT(Phase + NormFreq) ;Ready for next NCO sample 
i 

i 
: 
| 
| 
j 
: 
t 
' 
i 
i 

; 
: 


If HeadPointer = 0 then ;Only need to do this every 1024 samples 
SumI = 0 : SumQ = 0 ;Clear out any residue from last time 
fOrEx-= 30. toy, 2023 ;Use 1024 successive samples, can be any lower number 
TailPointer = (HeadPointer + 1 + X) MOD 1024 ;EARLIST sample in memory, 
; is that immediately AFTER the current head pointer. Move forwards to the latest. 
SumI = SumI + InputData(TailPointer, 0) 
SumQ = SumQ +InputData(TailPointer, 1) 


next X ;1024 summations of I and Q now complete 

Sumi = Sumi / 1024.) ; SumQ = SumQ / 1024 ;Normalised values 

SignalPhase = ATN2(SumI, SumQ) ;Full four quadrant phase calculation 
| Print Amplitude , SignalPhase ;we can do better than this, but its enough! 
| end if 
| FinishInterrupt 


} 


very dependent on the target language. If the pseudocode listings that fol- 
low appear to show any relationship to Power Basic, that is purely inten- 
tional! | 

The listing (Table 8.1) illustrates a number of processes common to the 
majority of DSP software. First, a few variables are set up for the sampling 
frequency and the local oscillator (equal to the tone frequency that will be 
converted to zero frequency). The normalised frequency term is calculated 
to be used in the NCO generation later. 

The whole programme is written such that one calculation loop is per- 
formed every time a new A/D sample arrives — by definition this must be at 
exactly the sampling rate. Either the software itself will generate the A/D 
conversion or, for example, characters arriving on the serial port at a con- 
stant rate will generate the processing event. The programme has to make 
sure that all input samples are correctly taken, at the right time, and that 
none get lost. In a dedicated DSP unit this could be generated by a hard- 
ware interrupt linked to the A/D converter. In a large operating system like 
Windows, the samples are just ‘handed’ to the software in blocks supplied 
from the sound card, these are sequentially worked through and the soft- 
ware then waits for the next block with no attempt to do this in real time. 
Correct timing of the input samples is handled only within the sound card. 
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Fig 8.6. Circular 
buffer addressing. 
Each new sample is 
stored at the head 
pointer location and 
overwrites the old- 
est sample. The head 


pointer is then 
incremented 
modulo 8 
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The first job is generation 
of the local oscillator by an 
NCO routine. For simplicity, 
the NCO is generated by 
calling the sin and cos func- 
tions, and in fact, when writ- 
ing in a high-level language 
running on a PC, this is usu- 
ally the fastest method as the PC’s maths co-processor contains very fast 
and efficient sin and cos generation routines. Within a custom DSP chip it 
is more usual to employ look-up tables rather than trying to calculate the 
sin and cos values. For each sampling period a variable (called Phase here) 
is continuously incremented by a fixed amount equivalent to the normal- 
ised local oscillator frequency. As it corresponds to an angle, the value has 
to increase progressively then jump back to zero. 

There are many ways to generate this angle — adding a fixed number of 
degrees, then taking the result modulo 360 to give an angle between 0 and 
360 is probably the most familiar way, but most software does not work 
with degrees. Calculating the angle directly in radians would be the ideal 
solution, but the mod (27) function is not mathematically possible as 1 is 
not a whole number, so we instead just take the fractional part of the number, 
which has the same effect as if we took the result modulo 1. The value 
obtained is then converted to radians for the sin and cos calculation by 
multiplying the resultant value between 0 and | by 2z. This solution to 
generating the NCO also means that the value by which the phase has to be 
incremented for each sampling period to give a correctly sampled LO wave- 
form is given exactly by its normalised frequency. There is also the advan- 
tage that many DSP chips work with binary values normalised to represent 
numbers between +1. So, when using these devices, the calculation almost 
becomes as simple as adding the phase increment, then taking the result 
‘raw’ and ignoring any binary overflow, exactly as would be the case for 
integer binary arithmetic. 

Every A/D sample is multiplied by the current instantaneous values for 
the I and Q terms of the local oscillator and the pairs of values of the fre- 
quency-converted waveform are stored in a circular buffer so that the last 
1024 values are always available. A circular buffer is used so that the latest 
set of samples are always available in memory, with each new sample 
overwriting the oldest one. Fig 8.6 shows the circular buffer addressing 
graphically. For this routine it would be just as easy to read a block into a 
fixed array starting at the top each time, and the use of circular buffers may 
appear a little long-winded when programming in a high-level language. 
However, array pointers and addressing will always be required whatever 
storage routine is adopted, as well as a means of moving the data around, 
and a circular buffer is one of the fastest and most memory-efficient means 
to achieve this. Custom DSP chips include a set of commands and address- 
ing modes that make access to a circular buffer automatic and virtually 
transparent to the calling routine. 


Oldest 
data 


Latest 
data 


pointer 
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Next, we test for the point at which a complete set of 1024 points of new 
data are in the memory - this is simply done here by testing for the input 
memory pointer to equal a value of zero. This event will occur every 1024 
cycles of the sampling frequency, and if this is at a rate of 10000 samples 
per second, the test will give a valid result every 10.24ms, or at approxi- 
mately 9.77Hz. For other sampling rates the frequency would change ac- 
cordingly. When this test is valid, we sum all 1024 I values and all 1024 Q 
values, and divide by 1024, giving the average value over the 10.24ms pe- 
riod. The final stage is to calculate the amplitude and phase of the result 
and display them. 

So what does this result actually represent? Consider an input signal that 
is a sine wave of arbitrary phase and frequency exactly equal to the NCO. 
If it were exactly in phase with the NCO I channel, the resulting SumI value 
would be a maximum and SumQ zero, similarly if the input waveform shifted 
by 90° the SumQ would be at a maximum and Sum! zero. So we have gener- 
ated the amplitude and phase of the input signal — which could have been 
done on each individual sample — but the averaging process has done a lot 
more than this. If the frequency varies very slightly, the result seen on a 
per-sample basis would hardly vary. However, over 1024 successive sam- 
ples each multiplication would produce an error from the result expected if 
the frequency were correct. The effect of these errors is to reduce the sum 
value quite rapidly as the frequency alters. In fact, at a tuning error of ex- 
actly half the repeat period, or 4.88Hz, the resulting SumI and SumQ will be 
zero. So, as this situation can occur at tuning errors above and below centre 
frequency, we have generated what amounts to a 9.77Hz band-pass filter 
followed by a power and phase meter. We have a 9.77Hz bandwidth AM 
receiver. 

As mentioned earlier, this process of multiplying an input waveform by a 
locally generated signal, then averaging (integrating) over a period is called 
correlation. As a tone detector it is not perfect — valid results will also occur 
(although the values will be lower) for tuning errors that sit at all odd har- 
monics of the bandwidth, but as an illustration of how DSP works it suf- 
fices. In fact this routine makes a good tone detector that can operate in 
parallel with other more complex DSP processes acting on, for example, 
voice signals that can be used to extract very low-level signalling tones con- 
cealed behind the main signal. 

Correlation forms a major part of many modem and data signalling proc- 
esses. The locally generated signal is not limited to just a sine wave; it can 
be any waveform at all, to match the shape of quite complicated transmit- 
ted signals. One example used by amateur radio operators for propagation 
monitoring is correlating an SSB receiver’s output with a locally generated 
signal that is a pre-stored representation of a signal that ramps from 200 to 
2500Hz in 20ms — a ‘chirp’ signal. Then, the correlator output is at a maxi- 
mum each time one of the many chirp sounder signals that sweep at a rate 
of 100kHz/s and are transmitted from around the world passes through the 
receiver pass band. By modifying the above programme so the summation 
is done for every received sample rather than just each time a new block 
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appears, it is possible to deter- 

Integration ; ies 
(filtering) mine the exact timing of the 
chirp to an accuracy equal to 
one sample period. This is 
made use of in the Chirpview 

: software written by GOTJZ and 
Amplitude 
comparison G3PLX [1]. 

It is also possible to correlate 
against several locally stored 
signals each time, rather than 
just the one. Then, by compar- 
ing each of the corresponding 
summed values, the maximum 
Fig 8.7.FSKdemod- is obtained from the one corresponding to the stored waveform that most 
ulatorusingapairof matches the transmitted waveform. By storing two tone frequencies, for 
correlators , , ; 

example, an FSK demodulator is the result as shown in Fig 8.7. 


Multiplication 


Tone F1 Tone F2 


Stored waveforms 


The fast Fourier transform 


If we want to look at a sampled input signal and determine its frequency 
content — for spectrum analysis, for example — one way to do this would be 
to generate a multiple correlator routine as described above with a set, or 
bank, of sinusoidal reference waveforms of different frequencies stretching 
from the lowest one equal to the frame repetition rate up to the highest 
possible limited by Nyquist. A convenient grid would be to hgve frequen- 
cies that are integer multiples of the block rate. For the example above, all 
the tones that are multiples of 9.8Hz up to a maximum of 5kHz would be 
tested by the correlator, 512 separate correlations in all. That way, the rela- 
tive levels (and phases) of each of the sum terms directly gives the spectral 
content of the input waveform to a resolution of 9.8Hz. This process was 
first invented by the mathematician Joseph Fourier as a mathematical trans- 
form on continuous data and used across a huge spectrum of engineering 
and scientific fields, not just for frequency/spectral analysis. In fact the Fourier 
transform was first used in calculating heat flow and also appears in calcu- 
lations with phased array antennas. 

However, the Fourier transform, or the discrete Fourier transform (DFT) as 
it should be called when used with fixed sampled data, is a very 
computationally intensive routine. For each of the ‘tones’ there are N com- 
plex (I/Q pairs) of multiplications and additions, so the relatively complex- 
ity is proportional to N*. Multiplication is easily the most time-consuming 
mathematical function in the process and dominates the calculation time. 
For the 1024-long block used above, over 1 million complex multiplica- 
tions would have to be performed every 10.24ms — something that is possi- 
ble with the latest PCs, but certainly not with the computers that were in 
existence at the time when Fourier analysis started to be widely used, around 
the ’sixties. 

However, at that time two mathematicians, Cooley and Tukey, noticed 
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that there was a lot of redundancy in the DFT process and that the process 
could be considerably simplified by applying certain limitations. They 
worked out that, provided the block length was an integral power of two, 
such as 8, 16. . . 256 etc, the DFT process could be progressively broken 
down into a series of 1-bit transforms, and the results re-assembled. The net 
result is then to eliminate all the redundancy in the DFT process and means 
that the resulting fast Fourier transform (FFT) now has a relative complex- 
ity of N.log, N complex multiplications rather than WV so the calculation 
proceeds considerably faster. As an example, the 1024-point DFT would 
have needed 1048576 complex multiplications, whereas by using the FFT 
this is reduced to 10240 — speeding up the process 100 times. The actual 
mechanics of the FFT process are rather complicated but for anyone inter- 
ested is explained in nearly all DSP texts — some in less mathematical terms 
than others. Complete descriptions are given in references [2] and [3]. 

The listing shown (Table 8.2) is one FFT routine written in Power Basic 
(or pseudocode). This particular routine was taken originally from a For- 
tran listing written almost at the time of the FFT’s invention, and only re- 
quired a few modifications to the syntax to convert to the Basic language. It 
has the property of storing the output (frequency domain) data in the same 
array as the input (time domain) data. So if the original data is still needed 
after FFT processing, a copy will have to be kept in another array. As the 
data array is complex (with real and imaginary terms), the input samples 
are stored in the real (or in-phase) half of the array, with the equivalent 
imaginary (or Q) locations being set to zero. After the FFT routine has 
completed, the first half of the array up to an index value of N/2 contains 
the complex coefficients of the spectral frequency-domain components. The 
second half of the array contains the same data in a mirror image — this 
corresponds to frequencies that would (or could) have been above the 
Nyquist frequency between 0.5 to 1.0 times the sampling rate. Each array 
location containing the I/Q amplitude coefficients for a frequency term is 
usually referred to as a frequency bin — as in dustbin. 


Negative frequency 

If, instead of filling the input data array with raw A/D samples and stuffing 
the Q channel with zeros, we fill the array with the I and Q components of 
a digitally down-converted I/Q signal, we get a very interesting and useful 
result — the output array no longer contains duplicate frequency spectra in 
mirror image. Now, the lower half of the array contains one frequency spec- 
trum from DC to half the sampling rate as before, but the other half of the 
array, from index N/2 to N, contains the lower sideband from the frequency 
conversion, also from DC going to Fs/2 in the other direction — negative 
frequencies. We have managed to extract and separate both overlapping 
spectra from the conversion. Now, since we have full non-overlapping cov- 
erage from —Fs/2 to +Fs/2 we have full spectral information for a band 
equal to the sampling rate. This concept appears to fly in the face of Nyquist, 
but is a natural artefact of being able to make use of negative frequency. 
Many professional engineers, let alone amateurs, feel uncomfortable with 
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Table 8.2. Fast Fourier transform routine converted to PowerBasic from Fortran 


| sub FFT(dat(1) , nn%) ;Enter with data stored in array called dat, and size of data block 


‘data format (re,im,re,im,....) starting at 1 
shared pi 33.141592653589793238462643383279 (approximately !) 
n% = 2 * nn% 
ipo tal 


for i% = 1 to n% step 2 
if j% > i% then 
swap dat(i%) , dat(j%) 
swap dat(i% + 1) , dat(j% + 1) 
end if 
m% = n% \ 2 
while m% >= 2 and j% > m% 
j% = j% - m% 


m% = m% \ 2 
wend 
incr j% , m% 
next 1% 
mmax% = 2 


while n% > mmax% 
istep% = 2 * mmax% 
theta = 2 * pi / mmax% 
wpr cos (theta) 
sin(theta) 


= 

mo} 
ery 
ll 


whist 
wi = 0 
for m% = 1 to mmax% step 2 
for i% = m% to n% step istep% y 
j% = 1% + mmax% 
tempr = wr * dat(j%) - wi * dat(j% + 1) 
tempi = wr * dat(j% + 1) + wi * dat(j%) 
dat(j%) = dat(i%) - tempr 
dat(j% + 1) = dat(i% + 1) - tempi 
dat(i%) = dat(i%) + tempr 
dat(i% + 1) = dat(i% + 1) + tempi 
next 1% 
wtemp = wr 
wr = wr * wor - wi: * wpi 
wi = wi * wor + wtemp * wp7i 
next m% 
mmax% = istep% 
wend 
end sub 


the concept of negative frequencies but it is a real mathematical concept, 
and of practical use in DSP where I/Q processing can really keep the two 
halves of the spectrum separate ready for reconstruction later. 


Windowing 
One difficulty with using the FFT to calculate the spectrum of discrete sam- 


pled data is what happens at the sampling boundaries. If we take an arbi- 
trary number of samples, say 1024, of a random input waveform then the 
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Discontinuity 
in start and 
stop amplitudes 


+— FFT sampling interval —> Multiply by windowing Modified input to FFT with 
function the discontinuity removed 


beginning and end of the sampled waveform will be discontinuous. This is _ Fig 8.8. Discontinu- 
illustrated in Fig 8.8. The effect of this is to cause spectral leakage across by eee aoe 
frequency bins, where the step transition causes a random raising of the 

level of many bins. It can be shown mathematically that at worst, approxi- 

mately 40dB signal/noise ratio is all that can be achieved with straight eight- 

bit sampling. 

The spectral leakage raises the noise floor to 40dB below the maximum 
level a single carrier at maximum amplitude could give. The way round 
this is to multiply the input data by a set of window coefficients so that the 
first and last samples in the block are reduced practically to zero — the ones 
in the middle of the sampled block are virtually untouched and those either 
side scaled proportionately. If this is done, the spectral leakage across all 
bins is reduced but at the expense of effectively widening individual bins. 
The bandwidth of each bin is no longer that of the block sample rate but is 
now wider. Spectral leakage is moved into adjacent bins rather than in to 
all of them in a random fashion. 

The amount of leakage that can be reduced, and the resulting new effec- 
tive bin width, is a function of the window type. FFT windowing is a huge 
area, the subject of many past studies, but for our purposes we only need to 
consider two or three different window types, each with different trade-offs 
between signal/noise ratio and effective bin width. 

Two of these are given in the software listings shown in Table 8.3. It is 
also possible to apply a window to the calculated frequency domain data 
after the FFT process, and in certain cases this can be a more computationally 
efficient way to proceed. 

Another way of looking at the need for windowing is to remember that 
the FFT calculates the spectrum of a block of signal in isolation, not a con- 
tinuous signal. Imagine instead of a block of data, a burst of single tone 
equivalent to the block length. If this is fed into a spectrum analyser the 
abrupt transitions at beginning and end lead to sidebands either side — simi- 
lar to key clicks. If the burst included several carriers, each would have its 
own key clicks which would overlap and make it difficult to reconstruct the 
original signal. 

The solution is to round off the edges of the burst by reducing their am- 
plitude — analogous to a key-click filter. The effect on the FFT is to elimi- 
nate the unwanted products, but since we have to round off the burst, its 
length becomes shorter, and a shorter burst means less resolution in the 
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Table 8.3. Two routines to window the time domain data before the FFT process in order to 


reduce spectral leakage 


' sub BlackHarriswind (dat() , n%) senter with data array (re,im, re, im....etc) 
shared pi 
fon ‘kei= 0) Tomneys 
locdat%’ = k%™¥* 2+1 
theta ’=-20% pie ka font 
dat(locdat%) = dat(locdat%) * (.42323 - .49755 * cos(theta) + .07922 * cos(2 * theta)) 
next k% 
end sub 


sub Hammingwind (datQ , n%) 
shared pi 
for k% = 0 to n%& - 1 
locdat%® = k% * 24+1 
theta = 2 * pi * k%/ n% 
dat(locdat%) = datClocdat%) * (.54 - .46 * cos(theta)) 
next k% 
end sub 


frequency domain. By starting with a longer block in the first place, and 
overlapping blocks, we can get back to the resolution we wanted in the first 
place albeit with increased processing complexity. 


The inverse FFT 


To complete the discussion of the FFT process, we note that the same rou- 
tine can be used for conversion in the opposite direction, from frequency 
domain back to time domain — this is achieved just by changing the sign of 
one of the multiplications in order to get the output results in the right 
order. Otherwise the FFT process is completely reversible, Convenes from 
time to frequency and back again. 

The ability to swap from frequency domain to time and back suggests 
one way of processing an audio signal. If we perform an FFT on an audio 
signal in real time, then modify the amplitudes of the resulting frequency 
bins in line with the wanted filter response, then do an inverse FFT (an 
IFFT) on the result, we generate a time-domain signal that has been fil- 
tered. The filter ‘shape’ is that of the weighting applied to the frequency 
bins after the first FFT process, Fig 8.9. The resulting time-domain values 
from the IFFT can be sent to a D/A converter to recover a real electrical, 
and possibly an audio, waveform. By adjusting the coefficients that are ap- 
plied to the frequency bins we can tune or adapt the filter at will. This 
method of producing a digital filter is a very complicated and rather ineffi- 
cient way of achieving an audio filter, and there are many better ways of 
digital filtering a signal. But it does allow arbitrary and unusual frequency 
responses to be obtained; modern computers and DSP chips are more than 
adequate in supplying the processing power needed. 

Some amateur software for the PC using a technique like this allows an 
arbitrary frequency response to be drawn — using the mouse — which is 
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immediately converted to a filter response 
and the processed audio is replayed though 
the sound card speakers [4]. 


Input 
waveform 


Digital filtering 
One method of digitally filtering a signal rittering 
has been described. However, there is a function .{}. 
much more generic, computationally effi- ace A 
cient and faster technique that can be used 

for the majority of filtering functions. 


. . . - . E + ——_> 
A basic digital filter, and the simplest to Frequency bins Gale these 
visualise, involves taking a number of suc- frequency bins 
: : selected and 
cessive samples of an input waveform, then weighted 


multiplying each one of these by a coeffi- 
cient and summing the results. For the next my baa He Da 
input sample, all the previous samples are weighted 

moved back one, the earliest is discarded een y 

to make room for the latest, and all are 
multiplied by the coefficients and summed 
again. The process is repeated for each 


: : : ayers Resultant 
sample and is shown in Fig 8.10. This is vntce 


known as a finite impulse response (FIR) fil- yd outa 
ter as the output is generated uniquely from 
a finite length of the input data. Generat- 
ing the coefficients for the multiplication 
is more complicated but does only have to be done once if the filter is not to Fig8.9. The FFT/IFFT 


digital filtering tech- 


be changed or tuned during operation. Usually fixed coefficients are stored neue 


in programme memory or calculated from first principles whenever the 
DSP chip is first initialised. So how do we generate the coefficients to give a 
particular filter shape, for a low-pass or band-pass response for example? 

A straightforward method is to make use of the fact that time-domain and 
frequency-domain data are interchangeable and can be converted from one 
to the other via the Fourier transform. An ideal low-pass filter in the fre- 
quency domain is a step response — a band-pass filter is often described as a 
‘brick wall’. If we take the Fourier transform (or strictly the inverse FT as 
we are going from frequency to time) of the wanted filter shape we end up 
with a series of time-domain samples, which by a happy coincidence just 
happen to be the set of coefficients needed for the multiply-and-add digital 
filtering. The same problems with spectral leakage apply so we usually need 
to include a window function as well. For the ‘perfect’ step or brick wall 
responses there is no need to perform an actual DFT on the shape, as the 
result is a well-known mathematical relationship (the sin (X )/X ) shape and 
the coefficients can be calculated from this equation at initialisation, or on- 
the-fly during operation if the filter response is to be altered. 

The filtering cannot be perfect, and the sharpness of the frequency tran- 
sition depends on the length of the block of data chosen. This, in turn, has 
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am to be chosen to allow reasonable 
samples processing speed and memory require- 
ments to be met. Obviously, the faster 
DSP processors with more memory will 
allow longer filter lengths and hence 
more precise filtering to be achieved. 
Normally block lengths of 32 to 1024 
are chosen and meet the requirements 
of most audio processing needed by 
amateurs. However, the filter shape can 
be much more flexible than anything 
produced by analogue means, the only 
Barat limitation being governed by the sam- 
samples pling rate/block length criteria. An- 
other disadvantage to long filter lengths 
is the time taken for a signal to pass 
Fig 8.10. Digital fil- through them. If the output is needed quickly for a fast turn-around, two- 
tering, the FIR filter Way system such as AMTOR, a fairly ‘soggy’ filter response may have to be 

tolerated since we cannot afford the time to let the filter fill up. 
One incidental advantage to the FIR filter is that it is inherently linear 
phase if the tap array is symmetrical about the centre — which is usually the 
way they are designed. As each output sample is a linear combination of a 
fixed number of previous samples, the time shift introduced by the filter 
must be fixed (equal to the block length/sampling rate) so the phase re- 
sponse cannot be anything other than linear. Linear phase is always a good 
thing to aim for on filters designed for audio as it minimises ringing and 
sounds better to the ear. The finite response nature means that classic filter 
shapes such as Butterworth, Chebyshev etc cannot be implemented per- 
fectly, although good approximations to their shapes can be obtained by 

Fourier analysis. 


Filtered 


Circular buffers in digital filtering 


Now the value of using a circular buffer that we first met in the correlation 
example should become more obvious. Every new input data sample re- 
quires accessing all the last N samples to do the filter function. So, by start- 
ing at the buffer location immediately in front of the point where the latest 
sample is stored in the buffer, which contains the oldest sample, then work- 
ing forwards, all N samples can be accessed quickly and in the correct se- 
quence without having to actually move any data in memory; only the point- 
ers are updated on each pass though. 

It is clear now that as we need to be able to do Ncomplex multiplications 
and a summation for every input sample, where Nis the number of histori- 
cal samples at any time in the block — the filter length. This is quite a lot of 
processing. All custom DSP chips include a command like MAC - multi- 
ply and accumulate —- which performs one coefficient multiplication and | 
sums with the previous value. This whole multiply-and-add command usu- 
ally takes up one DSP processor clock cycle, so the whole filtering process 
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takes N clock cycles per input sample. Point- nd 

ers need to be updated, but in most DSP chips samples 
this can occur in parallel with the MAC com- 
mand. So we are beginning can get an idea of 
the processing speed required for DSP. For 
filtering a 10kHz sampled signal, a 256-long 
filter will need a processor that can do 256 x 
10000 multiplications per second, or 2.56MHz 
assuming a hardware multiplier that takes one 
clock cycle to complete. This is hardly fast by 


modern standards and the DSP chips of a dec- 
ade or more ago run happily at 60-80MHz. 
Modern technology allows hundreds of mega- 
bY ts Tae ™) & & 


hertz so we can see DSP on audio signals is 
going to be a relatively straightforward task. 


The IIR filter 


Instead of just multiplying and summing in- 
put samples, another type of digital filter reads 
the output of the MAC command and sums 


Filtered 
output 


Ay to An 


Input coefficients 


By to By 


Output coefficients 


these with another set of multiply-and-accu- 
mulate commands derived from the last few samples of the output data, 
which is stored in another buffer. This is illustrated in Fig 8.11. Now, the 
data within the filter routine depends on all the previous samples, and the 
new result can affect, theoretically at least, all future output samples — hence 
itis known as the infinite impulse response (IIR) filter and reflects the situation 
in analogue filters. IIR filters are characterised by needing very much shorter 
block lengths for a given sharpness than FIR designs, so they can generally 
be used to much higher frequencies, but are more difficult to design and get 
going. They can easily become unstable if the coefficients are not exactly 
right, and one particular problem can occur due to summation of the math- 
ematical rounding errors present in integer maths; the MAC command can 
be very badly affected by biased rounding errors. This is to a large extent 
alleviated with modern DSP chips by using floating point arithmetic — but 
these still do not automatically ensure perfect IIR filter results, and so most 
amateur designs keep to FIR filters for simplicity and because they do work 
as they should. 


Decimation 


An audio input signal, say from an SSB receiver, will usually be sampled at 
arate not much higher than Nyquist allows. Typically, SSB audio is sampled 
at 8kHz and in some cases as low as 7.2kHz. However, if our aim is ultimately 
to filter this signal to a much narrower bandwidth, for signal analysis or 
narrow-band signalling for example, the results will come out of the digital 
filtering process still at the same sampling rate as they went in — this is a whole 
tenet of the DSP process, the sampling rate dictates everything. Now, a 


Fig 8.11. Infinite im- 
pulse response (IIR) 


digital filter 
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narrow-band signal, say only 30Hz wide (such as for the PSK31 data mode, 
for example), can be represented quite well at a sampling rate of twice this 
bandwidth — much lower than the existing value. 

If the sampling rate can now be lowered, the processing time that is per- 
missible for each sample can go up as there is now more time between each 
sample. Digital processing for data communications such as error detection 
and clock recovery can be much more complex than the frequency conver- 
sion and filtering just described, and the ability to do this at a reduced 
sampling rate considerably simplifies the task. The technique of reducing 
the sampling rate is called decimation. 

One way is to down-convert to zero frequency using I/Q mixing tech- 
niques, then low-pass filter the result to half the wanted signal bandwidth. 
Remembering that the I/Q mixing technique folds the spectrum over itself, 
low-pass filtering this has the effect of applying a band-pass filter to the 
original signal that is centred on the LO frequency. Now, we know the 
upper frequencies that can be present are dictated by the digital filter re- 
sponse, and that the zero frequency signal is now being over-sampled, ie 
sampled at a rate very much higher than its Nyquist frequency. What we 
can now do is just to take one sample out of every few, ensuring that the 
resultant new sampling rate is sufficient to meet the Nyquist criteria for the 
filtered signal. 

This can be shown by making use of a typical example. Assume a signal 
from an SSB receiver (300-3000Hz) is digitised at 8kHz sampling rate. We 
want to derive a 30Hz bandwidth signal centred on 1kHz to pass on to a 
demodulator or FFT routine. First, we down-convert to zero fgequency by 
making use of an NCO at 1kHz, synchronised with the input samples. This 
generates an I/Q signal, still sampled at 8kHz. This is then passed through 
a FIR filter with a cut-off of 15Hz — half of the wanted signal bandwidth. 
From experience we know that this degree of filter shape will need a length 
of around 1024. We also know that a signal of 15Hz can be safely sampled 
at any frequency greater than twice this, or at any value higher than 30Hz. 
So if we take one sample out of every 128 input samples we can lower the 
sampling rate to 8000/128 = 62.5Hz. (Although we could theoretically work 
with half this value, 31.25Hz, the leakage and imperfections in the digital 
filtering would lead to alias products. These are greatly reduced or even 
eliminated by adopting the higher rate.) We simply throw away the other 
127 samples out of every 128 that come out of the digital filter. 

Now for a little nicety that speeds up the whole DSP process no end! If we 
are going to throw away 127 samples out of every 128, then why calculate 
them in the first place? Digital filtering is quite time consuming and we don’t 
want it to use up so much processor overhead that the other more complex 
demodulation routines suffer. The output of the multiply-and-accumulate 
command at the end of a complete pass through the 1024 buffer samples 
contains the filtered output sample. However, since we want this only once 
out of each 128, why not just wait until then? Provided all the input samples 
are correctly stored in the circular buffer at the primary sampling rate, the 
software just has to test for every 128th character and perform its MAC 
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calculation on the buffer contents at that single event. The rest of the time can 
be spent doing other tasks. 


Ultra-narrow-band processing 


There is no reason why the decimation process cannot be continued further 
— the same technique can be applied again to further reduce sampling rate. 
From the example given above, exactly the same code and filter coefficients 
can be re-used to give anew sampling rate of 62.5/128=0.488Hz and a signal 
bandwidth of 0.234Hz. (The filter coefficients that were calculated for a 15Hz 
low-pass cut-off at 83000Hz sampling rate now give a new cut-off frequency, 
proportional to the change in sampling rate. Here it is 128 times lower at 
0.1172 Hz). Ifa 1024-point FFT is now performed on this data, the frequency 
spectrum of a narrow band centred on 1kHz (or whatever the NCO is tuned 
to) can be resolved to a resolution approaching 0.000477Hz. In practice, due 
to requirements for FFT windows the resolution bandwidth will be more like 
0.001Hz but thatis still very, very, narrow. Such bandwidths require extreme 
frequency accuracy to be of any use, and clock-rate error in the A/D 
converter can show up here, even assuming frequency errors in the receiver 
frequency conversion are eliminated. 

This mix-filter-decimate procedure is the backbone of much DSP-based 
narrow-band signal processing software, especially that using dedicated DSP 
chips and low-cost solutions. However, DSP software for spectral analysis 
on the PC does not always use this technique. PCs are characterised by 
having huge amounts of memory and fast maths co-processor chips, which, 
coupled with the fact that audio sampling rates are relatively slow com- 
pared with processor clock means that decimation is sometimes unneces- 
sary. In their signal analysis software, a number of software authors instead 
perform a huge FFT on the raw 8kHz sampled data. A 262144-point trans- 
form (2!) or 1M point (2”°) is quite feasible with the later generation of PCs, 
allowing direct viewing of signals in bandwidths of 0.03Hz or less. Refer- 
ence [5] gives details of a narrow-band spectral analysis package. 
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CHAPTER 


Practical DSP hardware 


digital signal processing, we need to look at the hardware and plat- 

forms available to run the software and then present or make use of 
the data. For the radio amateur, there are two routes that can be used, and 
each has its advantages. 


1 n order to make use of the various techniques available to us with 


Platforms for practical digital signal processing 


Where the main function of DSP is for analysis and decoding of signals, 
such as for data modes and spectrogram-type software, there is a lot to be 
said for using the processing power available in the modern PC. Further- 
more, high-resolution graphics are an integral part of all modern home 
computers and the Windows operating system means that the full graphics 
potential can be realised for real-time display of signal spectra or other 
parameters. The sound cards present in all modern machines make 
digitisation of audio straightforward and the huge processing power of ma- 
chines running with a 32-bit or 64-bit bus at clock speeds of hundreds of 
megahertz is hard to beat. This is the subject of the next chapter. 

However, where the requirement is for a small stand-alone unit, such as 
an audio filter or noise-reduction unit for connecting to the output from a 
receiver, dedicating a PC to the job is not usually practical. This is not to 
say it isn’t done. The SR5 software described in reference [5] of Chapter 8 
is an example of a user-defined audio filter with audio input and output via 
a PC sound card, although more generally a small dedicated unit is wanted 
that can be just switched on, and is then up and running immediately. Enter 
the dedicated DSP chip. 


DSP chip 


Before the days of PCs running at hundreds of megahertz, a custom digital 
signal processor chip was the only practical way to perform any real-time 
processing at audio frequencies. Within this chapter we will concentrate 
primarily on one brand of DSP chip, the 56000 family by Motorola. This is 
not to say that it is any better than those from other manufacturers, but it is 
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arguably one of the easier to understand and to begin programming from 
first principles. A low-cost evaluation module, the 56002EVM, based around 
this chip, made huge inroads into the use of DSP by radio amateurs in the 
’nineties. That particular module is regrettably now obsolete, and second- 
hand versions are snapped up even before they appear on the market. There 
is an updated version now available with a later DSP chip which can be 
used with most of the original software, although software modifications to 
suit the upgraded functionality and hardware will be required. 

A DSP chip is similar to any other microprocessor in the way it addresses 
memory, using several working registers and an arithmetic and logic unit 
for manipulating the data and moving it around. However, the difference 
comes in the types of instructions that are available, as well as some extra 
hardware included within the arithmetic unit. All the usual microproces- 
sor-type instructions such as fetch from and store to memory, and programme 
flow control such as jumps and branches, are present and programmed in 
the same way, so all the ‘normal’ jobs required of a processor can be per- 
formed. DSP chips always have a larger set of internal registers than micro- 
processors — these are separate from the memory map and are addressed 
directly by the machine-code instructions, so maximising speed by not hav- 
ing to address separate memory at all. Also present in a DSP chip is a hard- 
ware parallel multiplier since, as we saw in the last chapter, many DSP 
operations include repeated multiplications. The multiplier can usually per- 
form a complete multiplication on two words taking the full capacity of the 
processor bus, and give a double-precision answer in just a couple of clock 
cycles. The other main areas of difference in the hardware is,the memory 
addressing. Classic microprocessors (and the PC) make use of the same 
memory and address bus for both data and machine code — known as the 
von Neuman architecture. For this every data fetch requires an absolute mini- 
mum of two clock cycles, one to read and decode the machine instruction, 
the next to get the data it has to act on. Many commands take multiple 
clock cycles to complete so this architecture is not the best for speed, but 
does have to advantage of circuit simplicity as only one bank of memory 
has to be addressed and decoded externally. 

DSP chips employ a different architecture, where the memory for storing 
the programme code is kept separate from that for the data, with separated 
address and data busses for each. This is called the Harvard architecture and 
leads to a more complex hardware solution to manage separate busses, but 
now means that machine instructions and data can be accessed together. 
To further complicate matters, it is usually the case that the same physical 
address and data busses are used for accessing external memory, which is 
separated by the use of control lines. By ingenious use of multiple clock 
phases both sections of memory can be addressed within a limited number 
of clock cycles over the same bus. This is done to minimise the pin count on 
the chip package and simplify PCB layout. We don’t need to concern our- 
selves with how the DSP processor manages this bus-sharing task, however, 
as it is sufficient to know that there are functionally two separate areas of 
memory operating independently of each other. 
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The PIC processor described in earlier chapters also makes use of the 
Harvard architecture. Employed to speed up the processor to allow one, or 
in some cases two, clock cycles per instruction, there is no need for careful 
bus management on the PIC. All memory is internal and completely sepa- 
rate busses can be used with all connections inside the chip package. 

The DSP chip contains a certain amount of random access data memory 
on board which can be addressed even more quickly than external memory 
with its bus multiplexing, so allowing the most time-critical routines to be 
speeded up still further. There are also sections of read only memory con- 
taining data such as sine and cosine look-up tables, which can be switched 
in or out depending on the programmer’s requirements. 

One final area of note is the specialist addressing modes allowed. We saw 
the value of the circular buffer in the last chapter, and special registers with 
a number of specific machine-code commands and addressing options are 
available to set up and address these, while their use remains transparent to 
the routine that uses them by not having to separately calculate the address 
pointers. 

In most DSP chips there are many internal pathways between the regis- 
ters and arithmetic unit, and for many arithmetical commands, data can be 
moved around within memory simultaneously within the one instruction, 
provided they do not both need to address the same memory area or the 
same registers. For instance a circular buffer pointer can be updated whilst 
a multiplication is underway using the data stored in two registers. This 
allows programme memory to be conserved as all the commands are able 
to be stored together in one programme memory location. 


The Motorola 56000 DSP family 


The first DSP chips were 16-bit integer devices, but 16 data bits do not 
allow very high precision in repeated mathematical operations such as 
multiply-and-accumulate operations, and their application was limited. 
However, modems using them were feasible, as well as some simple real- 
time audio processing tools such as DSP filters and add-on dynamic noise 
reduction units. 

To remedy this, Motorola introduced a DSP chip making use of a 24-bit 
wide data bus with 24-bit registers, some of which could be doubled up, 
allowing 48 bits of resolution. Several devices in the 56000 family exist, 
with differences in the hardware included on each model to allow for differ- 
ent users requirements. However, all share a similar basic architecture as 
shown in Fig 9.1. 

The basic processor core features: 


* Operation at up to 20 million instructions per second (MIPS), making 
use of a 40MHz crystal 

° Single-cycle 24 x 23-bit parallel multiply-accumulator 

¢ Highly parallel instruction set with unique DSP addressing modes 

¢ Zero-overhead nested Do loops 

¢ Fast auto return interrupts 
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The DSP56002 device features: 


° 512 x 24-bit wide programme memory 

° Two 256 x 24-bit data memory 

* Two 256 x 24-bit data ROM (sine and cosine tables) 

¢ Full-speed memory expansion port with 16-bit address and 24-bit data 
busses 

¢ Synchronous serial interface port 

* Serial communications interface (asynchronous) port 

¢ 24 general purpose I/O pins 

¢ 24-bit timer event counter 

* On-chip emulator for unobtrusive, full-speed debugging 

* Optional programme security features 

¢ PLL-based clock with wide input frequency range multiplication and 
power-saving clock to reduce clock noise 


Address generation unit 


One of the most important parts of the 56000 architecture is the wide vari- 
ety of addressing modes available to simplify and speed up the common 
DSP tasks. Up to 64k of memory in the X bank as well as another parallel 
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Fig 9.2. 56000 ad- 
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64k in the Y bank can be addressed by making use of 16-bit wide address 
registers. It is also possibly to directly access the programme, or P, memory. 
Fig 9.2 shows a diagram of the address generation unit (AGU) integral to 
the DSP56000 family. There are eight triplets of 16-bit wide registers.and 
each triplet can be set up to perform linear, modulo and reverse-carry arith- 
metic, and operates in parallel with other chip resources to minimise ad- 
dress generation overhead. All three registers of each triplet are available 
individually for general-purpose 16-bit storage if they are not needed for 
addressing. 

A few examples of typical instructions illustrate best how the AGU is 
used. In all cases the type of addressing, as specified by the command syn- 
tax, is automatically placed in the associated M register by the assembler/ 
compiler: 


1. MOVE A1,X: (RO) 
Uses the single RO register from the first triplet to point to a location in X 
memory. The contents of accumulator Al are moved (or copied) to this 
location in X memory. 


2. MOVE B0,Y1: (R1)+ 
The R1 registers point to a location in the Y memory bank. The contents 
of accumulator BO are moved to here, and the address in RI is then 
automatically incremented by one to point to the next memory location. 


3. MOVE YO, Y: (R3)- 
Moves the contents of register YO to the Y memory address stored in R3, 
then decrements R3 by one to point to the previous location. 


4. MOVE X: -(R5), Bl 
Decrements R5 by one before generating the address. 


These first examples are all linear addressing modes, where the associated 
N registers are not used (and are available for general-purpose storage). 
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The following examples show some of the more complex modes possible 
that use the N register as well. 


5. MOVE Y1,X: (R6+N6) 
Moves Y 1 to the address in X memory formed by adding the R6 and N6 
register contents. 


6. MOVE X1, X: (R2)+N2 
As before for direct addressing with post increment, but now the address 
in X memory is post-incremented by the value in N2. 


7. MOVE X: (R4)-N4, AO 
Point to the memory location in X defined by the value in R4 and move 
its contents to accumulator AO. Then decrement R4 by the value stored 
in N4. 


The last three examples of offset addressing are defined by storing the val- 
ues OxFFFF in the associated M register. 

The next example shows modulo addressing as would be used with cir- 
cular buffers. The value of the modulo (minus 1) is now stored in Mn, and 
similar offset addressing modes as illustrated above are used. 


8. MOVE XO , X:(R2)+N2 (with M2 containing the modulo value minus 
one) 
The address in X memory is formed by adding the contents of N2 to R2 
then taking the result modulo (M2+1). Thus the address generated wraps 
round and is constrained to lie between the values of N2 and N2 + M2. 


Arithmetic logic unit y: 


The ALU contains hardware and interconnections for adding, multiplying 
and shifting data, as well as several general-purpose registers for feeding 
into these processes. Rounding logic is also incorporated to minimise er- 
rors caused by truncation of the results of calculations to fit into the 24-bit 
wide data storage. A block diagram of the data ALU is shown in Fig 9.3. 
Four 24-bit wide registers, XO, X1, YO and Y1 can form the input to the 
multiplier and the result can be stored or added to one of the two 56-bit 
accumulators. 56 bits are needed since, although a multiplication of two 24- 


_ bit numbers will give a 48-bit result, in the MAC command the results of 


many multiplications are added and this can easily exceed a 48-bit value. 
Hence 56 bits are allocated. Special commands are used to normalise a 56- 
bit result to generate a standard 24-bit result. By eliminating truncation of 
the intermediate multiplications within a MAC instruction, maximum ac- 
curacy of the final MAC summation is guaranteed so the DSP tasks that 
rely on this process will give the expected results. 

Within fixed-width DSP numbers are not usually specified as integers, 
although the machine stores numbers as signed two’s complement 24-bit 
values as a number between —2” to +2*' — 1 or approximately +2 billion. 
Instead, a fractional representation of numbers is adopted where the values 
are scaled to fit within the range -1 to (just under) +1. The fractional 
representation is derived by dividing the 24-bit number by 2”*. The use of 
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fractional numbers makes the maths inside 
the DSP software and processor much easier 
to visualise (sin and cos can be represented 
by their proper values for example). The 
processor automatically places the decimal 
point correctly when 48-bit values, or higher, 
are generated, and subsequently converted 
to 24-bit values. For example, the un-nor- 
malised value in the 56-bit accumulators 
described above can actually take on a value 
between —128 to +127.999... This fractional 
representation is only applicable to the ALU 
part of the DSP where the mathematics of 
DSP tasks are actually performed. Conven- 
tional integer representation is still required 
for tasks such as memory addressing and 
control of peripherals, and instructions allow 
both types to be dealt with unambiguously. 
The programmer does have to take care of 
which data type is in use though, especially if 
converting one representation to another as 
may be required when outputting the results 
from a calculation (in fractional format) to 
byte-wide data for a communications inter- 
face, or into 8-bit to 16-bit integers fora D/A 
converter. E139 


X data bus 


Y data bus 


and logic unit 


Accumulator, rounding 


Shifter/limiter 


“J 


A worked example of a 56000 DSP rou- 
tine serves best to show how the ALU operates: Table 9.1 shows the code 
for a FIR digital filter that filters I/Q data stored in X and Y memory re- 
spectively, according to filter coefficients stored in Y memory at location 
filcofs. A circular buffer has the length defined in fi 1size (all numeri- 
cal constants are defined earlier in the set-up code where they are given 
named values). Whenever this routine is called once per sample the R1 
register used as general-purpose storage contains the address of the latest 
data sample. R2 has been pre-loaded with the filter size. The line numbers 
in the listing are only for reference; they do not appear in any real assem- 
bler listing. 

The first line loads the filter size (from R2) decremented by one into the 
N2 register ready for modulo addressing. 

Line 2 clears the A accumulator ready for the multiply-and-accumulate 
to follow. 

Line 3 shows how certain types of command can be executed simultane- 
ously; as well as clearing accumulator B, the first filter coefficient in Y 
memory is loaded into R4 in a parallel move operation. 

Line 4 uses the L syntax to refer to X and Y memory together, referred to 
as long memory addressing. This mode performs the dual function of moving 
X(R4) to register XO and Y(R4) to register X1. 


Fig 9.3. 56000 data 
arithmetic logic unit 


179 


COMMAND - Computers, Microcontrollers and DSP for the Radio Amateur 


Table 9.1. DSP56000 code for a finite impulse response filter 


| 1) lua CR2) = 582. ;N2=filsize-1, loads N2 with updated offset 

: 2) air A 

f33 clr A;B ° Y¥:fticofs,R4 ;zero A,B; also point to selected filter 
4) move L:(R1)+,X ;get first I,Q pair into A+B together 
io move Y:(R4)+,Y0 s;get first coeff 

1 6) do N2,_end 

area) mac YO,xX0,B Y:(R1) , x0 

| 8) mac YO,X1,A X:(R1)+,X1 = Y:(R4)+,Y0 ;do the filter 

| 9)) Lend : 

+ 10) = macr Y0,x0,B ;finish the filter 


| 11) macr YO,X1,A Y:decmax, R4 p 


Line 5 gets the first filter coefficient from the filter table, using the pointer 
loaded in line 3. This illustrates one other area that programmers need to 
take care over. The data from a parallel move cannot be used immediately 
in the next instruction — instead there has to be some intermediate instruc- 
tion code(s) to allow the internal pipeline to complete all its operations. 

Line 6 sets up an operation that repeats all operations between the do 
command and the _end label, by the number of times stored in N2. Re- 
member that N2 is the modulo count for the circular buffer which in turn is 
equal to the filter length minus one, so this loop will be executed exactly 
fi lsaze =i times. 

Line 7 is the multiply-and-accumulate commands for I data , acting on 
the current values stored in the XO register multiplied by the filter coeffi- 
cient in YO and storing the result in accumulator B. The paratlel move in 
line 7 loads the next data value into X0, ready for the next iteration and 
based on the post-increment in line 4. The result is not available until three 
instructions later (when the loop returns to this same instruction). 

Line 8 is the Q data multiplication by the same filter coefficient in YO as 
was used for the I data and storing the result in accumulator A. Two paral- 
lel moves here update the X1 register with the next Q sample while post- 
incrementing the pointer ready for the next iteration, and also getting the 
next filter coefficient to YO. 

Line 9 defines the end of the loop which is passed through until all but 
the last single pair of I/Q data and the associated filter coefficient have 
been multiplied and added. 

Lines 10 and 11 perform the final MAC on the last I and Q samples 
respectively, but this special command also normalises the potentially 56- 
bit result in the accumulators back to a standard 24-bit value. The filtered 
result is available in A and B accumulators for whatever further processing 
is needed. 


Using the 56002EVM 


Once we have written the DSP code for our target processor, we then need 
to get in into the DSP hardware, then debug and test the code. The 
description that follows is specifically for the now-obsolete 56002 evaluation 
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module but the general principles are common to all DSP evaluation 
systems. 

The 56002EVM is supplied with all the necessary software to get it up 
and running, as well as example code that can be adapted to give all the set- 
up and initialisation instructions. Such code is always going to be specific to 
the hardware in use. The most important area is often that for setting up the 
CODEC, setting the sampling rate and audio gain settings. One of the ex- 
ample programmes which is supplied with the 56002EVM, called 
‘PASSTHRU.ASM’, is a complete listing including all set-up instructions 
that just takes an audio input from one, or both, of the line inputs, and 
passes it back out to the line outputs. While it has no DSP function in its 
own right, this little programme is absolutely invaluable for making the first 
tentative steps towards manipulating the data. It even includes a subroutine 
at the end of the listing called process_stereo which, as supplied, does 
absolutely nothing and just returns — it is in here that your first practice 
attempts at doing something with the audio samples can be added. 


Assembling the code 

Once the .ASM file has been written, the first stage is to assemble it into 
machine code ready for downloading to the hardware and Motorola have 
supplied a straightforward DOS/command prompt programme to do this 
part of the task. The command line assembler called ‘56000ASM” is in- 
voked by typing its name followed by the name of the source .ASM file. In 
practice, several command tags need to be included to control assembler 
output and a typical instruction to assemble the file ‘PASSTHRU’ is: 


56000ASM -a —-b —-1 PASSTHRU 


If all is correct (and if this file is exactly as supplied, it should be), a message 
will appear saying that assembly was successful. A number of new files will 
have now been generated, all with the same base name followed by differ- 
ent file extensions. The machine code is stored in the file with the .CLD 
extension. 

If there are any errors in the source code, the .CLD file will not be gener- 
ated. Instead, a description and the line number of the error will be written 
to an error file, eg PASSTHRU.ERR. The descriptions are quite concise, 
and usually point directly to the line of assembler that contains the error. 
Of course, this error checking cannot correct incorrect programme struc- 
ture or functioning, but it can pick up most typing errors and, more signifi- 
cantly, all illegal operations and addressing modes. 


Downloading to the DSP hardware 

The 56002EVM module is supplied with an RS232 serial link for 
downloading the operational code. A specific driver and debugging pro- 
gramme for the Windows operating environment called ‘EVM56KW’ is 
now used to drive the module via this interface. Other DSP cards may use 
the parallel interface which is generally somewhat faster than the serial one, 
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or the USB interface, or the DSP card may be supplied as a plug-in card for 
the PC. Whatever form the DSP hardware takes, software will always be 
supplied with it to make the assembling and downloading tasks as straight- 
forward as possible. 

Once EVM56KW is invoked, the name of the .CLD file is entered into 
the box and the download function started. A progress bar shows the 
downloading process, and when this is complete the DSP card is running. 
It’s as simple as that! The software allows multiple .CLD files to be loaded, 
such as filter tables that are generated separately if these are not specified as 
include files in the original source code. But there is more to EVM56K than 
just a downloader as it also contains many debugging tools for testing and 
help in getting your code operational. If the DSP software is not doing what 
it is supposed to, the code can be single stepped, line by line, and the con- 
tents of every register and sections of memory are visible at each step. Reg- 
isters and memory can be changed at will, and programme flow can be 
diverted, for example to get out of ‘stuck’ loops and illegal functions. 


Using Flash ROM 
Using EVM56K is a rather long-winded method of downloading code to 
the hardware — it can sometimes take several minutes. For proven code that 
you just need to get up and running immediately, there are two options 
available. Both methods require the addition of a 29C256 Flash ROM chip 
— containing 8k bytes of non-volatile memory — into the 28-pin ROM of the 
socket on the 56002EVM PCB. For a dedicated task that will run as soon as 
the module is powered up, or reset, the machine code can be directly stored 
in this Flash memory in a defined structure. A boot programme within the 
56002 chip itself automatically downloads the contents of this ROM to the 
correct location in the DSP memory and starts running the code as soon as 
the download is complete. This only takes a fraction of a second and the 
results appears to be that the DSP system is running as soon as it is turned 
on. This immediate download is the preferred method for single-task dedi- 
cated jobs such as software receivers, audio filters and the like. 

Loading the contents into the Flash memory in the correct format is made 
straightforward by a public domain utility called ‘FLASH’ which is avail- 


_ able from reference [1]. The .CLD file is loaded into the EVM56K software 


as normal, but not run. Then file FLASH.CLD is loaded onto the end of the 
DSP code and the end address in bytes is inserted into register R1 using the 
debug tools. When this combination is run, the DSP code is blown into the 
Flash ROM ready for downloading next time the DSP card is reset. Full 
instructions are provided with the software. 

The other option is a sort of half-way house between instant access to a 
single programme and the flexibility of using EVM56K. A utility written by 
Peter Martinez, G3PLX (although broadly compatible versions written by 
others also exist) works as follows. A loader programme called 
‘PLXBOOT.CLD’ is saved in Flash memory as detailed above — this runs 
as soon as the 56002EVM is booted up and monitors the serial port input 
for incoming data in the correct format. On the attached PC, a programme 
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Fig 9.4. Circuit dia- 
gram for !l/Qup-con- 
verter 


SSB RF 
output 


+5V 


RF clock 


Sideband 
select 


E140 


called ‘EVMLOAD?’ is run, followed by the .CLD file name, eg EVMLOAD 
PASSTHRU, at which point the contents of the .CLD file are uploaded to the 
DSP card via the serial link with error checking. The process is consider- 
ably quicker than going via EVM56K, and furthermore can be automati- 
cally invoked by building the source code or instructions for EVMLOAD 
into any user software, or by calling the loader directly from the programme. 
All code and instructions are available from reference [1]. 


Phasing SSB generator 


The listing in Table 9.2 was written by Peter Martinez, G3PLX, for directly 
generating an SSB signal at RF. The DSP code serves the same function as 
the audio 90° network, usually constructed from op-amps and close-toler- 
ance components such as the polyphase network and others. It was written 
for the sound card but the routine can be adapted for any DSP card. The 
routine takes an audio input and generates I and Q audio channels, which 
are then connected to mixers driven by a quadrature local oscillator signal 
at the carrier frequency. The circuit of a suitable up-converter is shown in 
Fig 9.4. The result is a single sideband output RF at the LO frequency. 


183 


COMMAND - Computers, Microcontrollers and DSP for the Radio Amateur 


- Table 9.2. Listing of DSP code for generating the audio phase shift for a phasing-type SSB gen- 


erator 


(First the Hilbert transformer array) 


/ const filsize=79; 
hilbert:array[0..filsize-1] of extended= {100-3900Hz, unwanted sideband -70dB} 


| -4.42695301937857E-04, 
~9.53526423361772E-04, 


1.67113161892970E-07, -5.84056554099099E-04, .69758824038231E-07, 
8.89408808871749E-07, -1.46227490318296E-03, 1.30587843953471E-06, 
-2.14255405309416E-03, 1.64359475954973E-06, -3.03113766834784E-03, 1.82856752954826E-06, 
-4.17043518526583E-03, 2.09966944102538E-06, -5.61016681715643E-03, 2.43741687373789E-06, 
-7.41083969128908E-03, 2.86204580954991E-06, -9.64869830345094E-03, 3.02602387210887E-06, 
-1.24247641710582E-02, 3.35546916410343E-06, -1.58812223256461E-02, 3.11595936939441E-06, 
-2.02296744714943E-02, 3.33561855543618E-06, -2.58089096096512E-02, 3.00143211246981E-06, 
| -3.32026373168333E-02, 2.59458196245899E-06, -4.35174797055993E-02, 2.29710708936001E-06, 
-5.91353542527600E-02, 1.85085624239585E-06, -8.62724013162506E-02, 1.28645138782781E-06, 
| -1.47770892289600E-01, 7.56638196995445E-07, -4.49393158790826E-01, -7.07106781186667E-01, 
.49393158790826E-01, -7.56638196995445E-07, 1.47770892289600E-01, -1.28645138782781E-06, 
.62724013162506E-02, -1.85085624239585E-06, 5.91353542527600E-02, -2.29710708936001E-06, 
-35174797055993E-02, -2.59458196245899E-06, 3.32026373168333E-02,-3.00143211246981E-06, 
- 58089096096512E-02 , -3.33561855543618E-06, 2.02296744714943E-02,-3.11595936939441E-06, 
. 58812223256461E-02 ,-3.35546916410343E-06, 1.24247641710582E-02, -3.02602387210887E-06, 
.64869830345094E-03, -2.86204580954991E-06, 7.41083969128908E-03, -2.43741687373789E-06, 
-61016681715643E-03, -2.09966944102538E-06, 4.17043518526583E-03,-1.82856752954826E-06, 
.03113766834784E-03 , -1.64359475954973E-06, 2.14255405309416E-03, -1.30587843953471E-06, 
-46227490318296E-03, -8.89408808871749E-07, 9.53526423361772E-04, -4.69758824038231E-07, 
.84056554099099E-04, -1.67113161892970E-07, 4.42695301937857E-04 


YVYOrPwWwWunoOorRN f OL 


Now a type declaration which is self-evident: 


type Taudio=record 
j left, right: smallint {16-bit signed binary} 
end; 


| Nextthe SSB function, which takes a (stereo) audio input and returns a stereo result. The two sound card outputs 
| go tol and Q DBMs, perhaps with a little bit of amplitude balancing to take out gain tolerance. The left stereo 
_ input ends up as the USB and the right stereo input as LSB, so it will even do ISB. A Pascal ‘const’ is a persistent 
| local variable that keeps its value between calls to the function, but is not accessible outside the function. A 
_ ‘var’ is a transient local variable on the stack. 


| function SSBCinput: Taudio) : Taudio; 


const filptr:cardinal=0; {i.e. an integer} 
var I,Q,U,L:extended; (floating-point numbers} 
tap:cardinal; 
| begin 


U:=input. left/32767; 

L:=input.right/32767; 

Ifil[filptr] :=Cu+L)/2; 

Qfil[filptr] :=Cu-L)/2; 

filptr:=(filptr+1); 

if filptr=filsize then filptr:=0; {Ifil and Qfil are circular buffers} 
t=O 
Q:=0; 

for tap:=0 to filsize-1 do 
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Table 9.2 (continued) 
begin 
I:=I+hilbert[tap]*rfil{filptr] ; {+45 degree Hilbert filter} | 
Q:=Qthilbert[filsize-tap-1]*Qfil[filptr]; {-45 degree “backwards” Hilbert filter} 


filptr:=Cfilptr+1); 

if filptr=filsize then filptr:=0 
end; 
SSB. left:=round(1*32767); 
SSB. right:=round(Q*32767) 


end; ; 
2 oad ee ee ee Cree ee Ae eee ee 


The code is written in Pascal (with a few notes on variable types), and 
only shows the part of the function that processes each audio sample; all the 
other set-up instructions will be hardware and operating system dependent. 
If using a sound card, it should be set up for 16-bit stereo operation. As it 
stands the programme is intended for 8kHz sampling rate, but if this is 
changed, the frequency response just scales in proportion. The filter array 
is a modified Hilbert transformer, in which the phase shift is 45° over the 
audio band rather than 90°. This is used to process audio for the I channel. 
The same array is used back-to-front to do a —45° shift over the same band 
and that is used for the Q channel. Using a 45° phase shift is hugely better 
than having a 90° Hilbert in one leg and a delay-line in the other. The filter 
is all-pass within the limits imposed by its length and the Nyquist criterion. 


References 


[1] The Tucson Amateur Packet radio group, TAPR, have an extensive 
collection of 56002EVM software, as well as a collection of software for 
other DSP chips, on their website: www.tapr.org. 
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Interfacing the sound card under 
Windows 


The event-driven model 


One day it happened. It had to happen. Suddenly I found myself sitting in 
front of my PC, staring at a blank screen, with the keyboard waiting for me 
to type some arcane instructions to Windows, in order to persuade it to 
display a pretty panel and to accept orders based on the fact that some 
button had been pressed (or ‘clicked’, as the jargon dictates). 

I had been up to that day a die-hard PC-DOS and microcontrollers pro- 
grammer, whose motto was: “Real programmers don’t use GUIs” where 
‘GUP, for the uninitiated, stands for ‘graphical user interface’, the Holy 
Grail sought first by the Menlo Park labs of Xerox, then by Apple and 
finally by some Redmond firm, producer of operating systems for the IBM 
(and compatible) PC. However, progress is progress, and it was time to say 
goodbye to my principles. 

Enter the wonderful world of the event-driven model of programming. 
This is the first mental obstacle the would-be Windows programmer has to 
face. The so-called procedural model is the earliest 
that the apprentice programmer learns in his life, 
and the most intuitive. A programme is just a se- 
quence of instructions, where the CPU is com- 
manded to perform some tasks in the exact order 
the programmer had in his mind. Simple and beau- 
tiful. But there are some drawbacks. 

What in a nutshell you do is to trade flexibility for 
simplicity in writing your programme. To see why, 
let’s make an example taken from our hobby, ie 
amateur radio and electronics in general. Suppose 
you want to write a programme to interactively com- 
pute the response of a low-pass filter, with the number of poles not fixed in _ Fig 10.1 
advance. There are at least two possible solutions, inductance-input and 
capacitance-input, with the added unknown of the number of poles (Fig 
10.1). 

So, how would you manage this in a strictly procedural language? There 
are not many choices. You have to pose a series of questions to the user of 
the programime, to understand what he has in mind, something like this: 
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c:\>dofilter 

Please type 1 if inductance-input, 2 if capacitance-input? 1 
Now please type the number of poles: 4 

Ok, now type the value of L1: 100e-6 

Ok, now type the value of Cl: 560e-12 

Peet agte.s BEC! CEC TOE Ur ttee snare ate ceetetate 


This would of course work, but what if you change your mind after having 
entered all of the values, and you want now to model a capacitance-input 
filter? You must redo everything from the be- 
ginning for a different number of poles. 

On the other hand, a very simple event-driven 
Windows programme to accomplish the same 
task could look like that shown in Fig 10.2. 

The user enters the data in any order, and 
only when he presses the ‘Compute response’ 
button is all the data analysed and the response 
computed. And don’t be misled by the fact that 
the above panel has only four input fields both 
for capacitance and inductance. When the 
‘Number of poles’ input field receives a valid 
Fig 10.2 value, more (or less) fields where to specify capacitance and inductance 

values will be displayed, with the panel changing size to accommodate them. 

What happens behind the scenes? Each time a field receives a value ora 
button is pressed, Windows notifies the fact to the programme, \ which must 
then react accordingly, eg by storing the value of the component or chang- 
ing the computation algorithm that will be afterwards used, or showing a 
different number of input fields on the panel. In other words, the programme 
must react to the events caused by user actions and duly reported by Win- 
dows. These events can be generated in any order, and the programme 
must be prepared for this, possibly generating error messages if the input is 
invalid (eg missing number of poles or the value of a component). This is 
maybe the greatest change of attitude the Windows programmer has to face 
when switching from a command line environment. He is no more in con- 
trol of what happens - the user is. 

To better explain all of the above, and to render justice to the title of this 
chapter, we will now examine in detail a simple Windows programme, 
whose purpose is to read digitised audio data from the sound card, apply a 
comb filter to it, and play back the filtered audio from the speakers. A 
comb filter, in case you don’t know, is just a series of narrow notches placed 
at the multiples of a given frequency. It derives its name from the fact that 
its spectral response looks like an ordinary comb. Its main use is to filter out 
the hum generated by the mains and its harmonics. To make it useful also 
on the other side of the Atlantic, the fundamental frequency can be chosen 
to be 50 or 60Hz. As it seems to work rather well, I gave it the name HU- 
MID, which is an acronym of ‘HUM Instant Destroyer’. Please don’t blame 
me for this choice of name! Its panel looks like Fig 10.3. 
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Special attention will be a HUMID- Hum Instant Destroyer ¥1.2 
given to the sound card inter- | 
facing portion of the pro- 
gramme, so that it can be taken 
as a model for whatever pro- 
grams one could wish to write 
to process audio, for a amateur radio related (or otherwise) application. 
The comb filter implementation is in a separate subroutine, and the algo- 
rithm is modelled after a programme of Paul Nicholson [1] with his permis- 
sion. The entire listing of HUMID is in Table 10.14 at the end of this chap- 
ter, and we will examine it step by step. 

I suggest the reader gets hold of the free Borland C/C++ compiler, which 
can be downloaded from reference [2]. When you are on that page, select 
the third choice in the table, the one that says ‘Compiler’. You will have to 
agree to the licence statement and to register, but then the download is free 
of charge. With this compiler you will be able to compile HUMID and to 
test modifications you can make to it, or to build your own Windows appli- 
cation. Follow the instructions in the package regarding installing; it is in- 
deed a very simple process. 


HUMID 


I said before that everything is governed by events. I should have more 
correctly said that messages are the key pivot at the heart of Windows. When 
an event happens, Windows sends a message to the programme that ‘has 
the focus’, which is an expression that indicates the window (programmes 
interact with the users through panels called windows) that, at that point in 
time, will receive all the mouse and keyboard input. This generally is the 
window which is in front of all the others (but there are exceptions). The 
programme examines the message and decides whether it has some actions 
to perform to handle it, or not. In other words, the programme sits in an 
idle loop, waiting for messages from Windows. Once it has processed a 
message, it just waits for the next. This loop is called the window procedure in 
practically all books devoted to the subject of Windows programming. The 
programme, as part of its initialisation, sets up that window procedure, and 
passes a pointer to it to Windows. 

Let’s see how this is done in HUMID. The beginning of the programme 
is shown in Table 10.1. 

Nothing strange here, we have declared some variables we will need 
afterwards. The structure array button contains some data (the style, the 
caption and whether it is enabled) that will be used to create the four 
pushbuttons present in the HUMID window. Generally speaking, all the 
variable types in uppercase are defined inside the header windows .h which 
in turn is included by humid.h. Don’t be too worried about their exact 
meaning just now — when you are more proficient in the art of Windows 
programming, you can look them up in the Windows documentation. Just 
a few additional words: srate is the sampling rate that the sound card will 


HUMID is now in filter mode, tuned at 58 Hz 


Fig 10.3. HUMID 


189 


COMMAND - Computers, Microcontrollers and DSP for the Radio Amateur 


Table 10.1 


| #include "humid.h" 
struct 
{ 
long style ; 
char -*text.’: 
BOOL enabled; 
} button[] = 


{ 
BS_PUSHBUTTON, 250 HZ ee FALSE, 
BS_PUSHBUTTON, "60 Hz", TRUE, 
BS_PUSHBUTTON, "Activate", FALSE, 
BS_PUSHBUTTON, "Bypass", TRUE 
3} 
BOOL Hz50 = TRUE, Active = TRUE; 
jnt srate = RATE; 
HWND hwnd; 


/ HANDLE BufferThread, Processthread, InBufferReady, OutBufferReady; 
| HWAVEIN hin; A 

HWAVEOUT hout; 

WAVEHDR inhdr[NINBUF], outhdr[NOUTBUF] ; 

RECT rect, screen ; 


be set to. BufferThread and ProcessThread are the handles (fancy word 
that has more or less the meaning of ‘pointer’) of the two additional threads 
(besides the main programme) that compose HUMID. 

I hear many of you saying, “Threads? What on earth do you mean by 
that?” You are quite right. I haven’t talked about threads yet. "Explaining 
them fully is a bit beyond the purpose of this chapter, but in a nutshell a 
thread is an indivisible unit of execution, a chunk of work that the CPU is 
assigned to chew upon, until it is somehow interrupted and assigned a new 
thread. Windows itself is composed of threads, and so are user programs. It 
is not uncommon to find hundreds, even thousands, of threads present in 
your PC at some point in time. The advantage of threads is that they can be 
interrupted (and resumed later on), so that the CPU can work on a higher 
priority one if need be. In the case of HUMID we have two of them, plus 
the main programme, also a thread. One to manage the re-queuing of the 

' input audio buffers to the sound subsystem (more on this later) and the 
other to perform an analogue function for the output buffers just after the 
signal processing functions of the comb filter has been done. Using threads 
has the advantage of higher user interface responsiveness. In other words, 
what would happen without threads is that, for example, if you pressed a 
button while the programme is engaged in a lengthy computation, your 
action would not be recognised and acknowledged until the end of the 
computation, causing a sluggish response by the programme. 

Back to the HUMID code (Table 10.2). winmain takes the place of the 
main routine of a classical C programme. Its parameters are almost always 
as declared above — just use this format and you will be fine. With the call to 
the Windows API GetwindowrRect (‘API’ is an acronym of ‘Application 
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int WINAPI WinMain (HINSTANCE hInstance, HINSTANCE hPrevinstance, 
PSTR szCmdLine, int iCmdShow) 


MSG msg ; 
WNDCLASSEX wndclass ; 


' 

| 

‘ 

| 

static char szAppName[] = "Humid" ; 
i 

i 

: 

{ 

; 

1 GetwindowRect(GetDesktopwindow(), &screen); 
i 

j 

i rect. left = screen.right/2 - 250; 

rect.top = screen.bottom/2 - 60; 
rect.right = rect.left + 500; 

: rect.bottom = rect.top + 120; 


: ‘wndclass.cbSize = sizeof (wndclass) ; 

wndclass.style = CS_HREDRAW | CS_VREDRAW ; 
wndclass.|lpfnwndProc = wndProc ; 

wndclass.cbClsExtra SOs 

wndclass.cbwndExtra- = TOE 

wndclass.hInstance = hInstance ; 

wndclass.hIcon = LoadiIcon (NULL, IDI_APPLICATION) ; 
wndclass.hCursor = LoadCursor (NULL, IDC_HAND) ; 
wndclass.hbrBackground = (HBRUSH) GetStockObject (WHITE_BRUSH) ; 
wndclass.lpszMenuName = NULL ; 

wndclass.IpszClassName = szAppName ; 

Pees eae aie Be pe Re SOE I WE PS eee Slee 


wndclass.hiIconsm = LoadIcon (NULL, IDI_APPLICATION) ; 


Programme Interface’, all the functions that Windows makes available to 
user programs to perform a variety of tasks — there are more than 1000 of 
them), we are asking what the screen size is to place our window just in the 
centre of the desktop. The following instructions set some characteristics of 
the wndclass structure, which represents our window. I won’t go through 
each one, as you can easily find what they do by perusing a Windows API 
reference book, which is a highly suggested companion to be kept near the 
PC keyboard. One instruction to be noted is: 


wndclass.IlpfnwndProc = wndProc; 


Here we set inside the wndclass structure the pointer to our window pro- 
_ cedure, our message processing loop. Talking of reference material, a book 
you cannot do without is the excellent Programming Windows 98 by Charles 
Petzold, published by Microsoft Press. Everything not explained here for 
space reasons is covered in that book, in more than 1000 pages! If you are 
serious about writing Windows programas, get hold of it. 

Let’s continue with the HUMID code (Table 10.3). We are building here 
the foundations of our programme. First, we register with Windows our 
window procedure class wndclass, then we create the main window of 
the programme, specifying its caption, the style, where it must positioned 
on the desktop and its size. Then we show it by calling Showwindow. Note 
that this API shows only the Windows-managed part of the panel, ie the 
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Table 10.3 


RegisterClassEx (&wndclass) ; 
hwnd = Createwindow (szAppName, " HUMID - Hum Instant Destroyer V1.2", 
WS_CAPTION | WS_SYSMENU, 

rect.left, rect.top, 

500, 120, 

NULL, NULL, hInstance, NULL) ; 


Showwindow (hwnd, iCcmdShow) ; 
Updatewindow Chwnd) ; 


borders, the title, and the small icons at the top left and top right. The actual 
content of the window, the so-called client area, is left to the responsibility of 
our programme, and this is done by calling Updatewindow. The effect of 
this call is just to generate a message to our window procedure, telling it 
that the client area of the main window must be refreshed. This is a very 
important point to keep in mind. Our programme must always be ready to 
regenerate the entire contents of the window upon request by the operating 
system. Don’t overlook this point. Whatever change you make to the win- 
dow contents, you must be able to do it again, should it be needed. And the 
need could be caused, by example, by your window being hidden by an- 
other one, and then brought again in front. Windows doesn’t save what you 
were showing. When your window becomes again visible, it just asks you to 
redraw it. This is another point where the apprentice Windows wizard of- 
ten fails. The implication of all this is that you must keep track of the status 
of what you are showing. When we declared the four pushbettons at the 
beginning of the programme, we used a structure that has a member named 
enabled, which is a Boolean variable. This variable holds the current 
‘pushability’ status of its associated button. If I push the 50Hz button, then 
it must become disabled, as there is no point in pressing it once more. 
Instead, the 60Hz button must now be enabled. By storing the status of the 
buttons, it is then possible to redraw them, when Windows asks, in a way 
showing their respective enabling status. 

Let’s go on (Table 10.4). Finally we have found the main processing loop, 
the heart of our programme. The GetMessage API doesn’t return to the 
caller until Windows has a message for us. When there is one, we call 
Trans lateMessage. The TranslateMessage function translates virtual- 
key messages into character messages. The character messages are posted 
to the calling thread’s message queue, to be read the next time the thread 
calls the GetMessage or PeekMessage function. To actually send the mes- 
sage to our window procedure, we use DispatchMessage. The 
DispatchMessage function dispatches a message to a window procedure. 
It is typically used to dispatch a message retrieved by the GetMessage 
function. This last sentence has been copied verbatim from the API help. If 
all this looks unnecessarily complicated and involved, well, it is. But then 
you haven’t seen anything yet, as far as Windows is concerned. 

Note the return msg.wParam instruction. This is where our programme 
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Table 10.4 


while (GetMessage (&msg, NULL, 0, 0)) | 
: | 
TranslateMessage (&msg) ; | 
DispatchMessage (&msg) ; i 

} | | 
return msg.wParam ; | 


ends. And we reach this instruction when the GetMessage API returns a 
return code of zero. This is the method used in Windows to terminate a 
programme. But now we have reached the point where things get done, the 
window procedure (Table 10.5). Basically it is a giant switch case con- 
struct, where the identifier of the message just received from Windows is 
examined and acted upon. 

There are a lot of things to explain here and a problem: if I go too much 
in detail, then the outcome will be a replica of Petzold’s book. Too little 
detail, and you will feel dissatisfied, not having grasped enough of the sub- 
ject to justify the use of your time reading this chapter. I will try to stay in 
the middle ground, but please bear with me if I don’t always succeed! 

We will examine the declarations at the beginning of this routine while 
we use them. Note that the entire procedure is a single switch case con- 
struct, and the code above reports the first case, the WM_CREATE. Windows 
sends a WM_CREATE message to our procedure when, logically enough, our 
window is being created, in order to allow us to perform one-time initialisa- 
tion tasks like, in our case, setting up the comb filter, opening the sound 
card etc. 

The first thing we have to do is to know how large the characters on the 
screen are! This may sound odd, but it isn’t. Windows permits the use of 
various character sizes with different fonts, and we want to size our buttons 
so that their labels do not spill outside the button borders. Without entering 
into too much detail, first we obtain a so-called device context, which is a 
handle to the virtual painting area on the screen. We do this with the GetDC 
call. Then, using a couple of APIs, we set the two variables cxChar and 
cyChar that indicate the horizontal and vertical sizes of the characters used. 
Now is the time to actually create the four small windows that represent our 
four buttons. Remember, in Windows almost everything is a window (par- 
don the pun), so the buttons are created with the Createwindow API call, 
using the button structure declared at the beginning of the programme, 
and the character sizes just found to compute a correct button dimensioning. 

Then we try to initialise the comb filter — in case of failure we display a 
“We are sorry but . . .” type of message, and we also tell Windows to put 
into the message queue for our programme a WM_QUIT message, which will 
be retrieved by the GetMessage API, causing it to return with a return 
code of 0 (zero), terminating the programme. We will examine the 
SetupComb function later on. Same logic for the two functions 
SoundOpenInput and SoundOpenOutput, whose description is also 
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Table 10.5 


LRESULT CALLBACK WndProc C(HWND hwnd, UINT iMsg, WPARAM wParam, LPARAM 1Param) 
{ 
static char msg[128] = “HUMID is now in filter mode, tuned at 50 Hz"; 
static HWND hwndButton[NuUM] ; 
static int  cxChar, cyChar ; 


HDC hde. 4 
PAINTSTRUCT ps ; 

int Paks 
TEXTMETRIC tm ; 

long style; 

DWORD thidl, thid2; 


switch (iMsg) 
{ 
case WM_CREATE : 
hdc = GetDC Chwnd) ; 
SelectObject (hdc, GetStockObject (SYSTEM_FIXED_FONT)) ; 
GetTextMetrics (hdc, &tm) ; 
cxChar = tm.tmAveCharwidth ; 
cyChar = tm.tmHeight + tm.tmExternalLeading ; 
ReleaseDC (hwnd, hdc) ; 


for Gi = O0°3°5 < NUM 3 7+4+) 


{ 
style = WS_CHILD | WS_VISIBLE | button[i].style; 
if(!button[i].enabled) style |= WS_DISABLED; 
hwndButton[i] = Createwindow ("button", button[i].text, ¥ 
style, 
CxGharire S804) ae > SCY Ghani se 
hwnd, (CHMENU) 7, 
(CLPCREATESTRUCT) |Param) -> hInstance, . 
NULL) ; 
} 
if(C!Setupcomb() // initialize the comb filter 
¢ ; 
fatal("Unable to allocate filter buffers"); 
PostQuitMessage (1) ; 
} 
if(!SoundoOpenInputQ || !SoundOpenoutput() ) 


PostQuitMessage (1) ; 


InBufferReady = CreateEvent(NULL, FALSE, FALSE, NULL); 
OutBufferReady = CreateEvent(NULL, FALSE, FALSE, NULL); 


BuffertThread = CreateThread(NULL, 0, ReQueBuffers, 
0, 0, &thidl); 

ProcessThread = CreateThread(NULL, 0, OutputAudio, 
0, 0, &thid2); 


| 
/ 
| 
| 
| 
| 
| 
/ 
| 
| 
10 = .GxGhalin b/asewGY.Cnalas /a5,5 | 
| 
| 
| 
| 
| 
| 
: 


if(NULL == BufferThread || NULL == ProcessThread) © 
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{ 
fatal("Unable to create processing threads"); 
PostQuitMessage (1) ; 

¥ 


SetThreadPriority(BufferThread, THREAD _PRIORITY_HIGHEST) ; 
SetThreadPriority(ProcessThread, THREAD_PRIORITY_HIGHEST) ; 
| // if everything ok so far, then tell MMAPI to start recording 

// but only when we will have plenty of free output buffers 


whi 1e (TRUE) 
{ forcCk=0; k<NOUTBUF; k++) 
ifCouthdr[k].dwuser != 0) break; 


| 

if(k>=NOUTBUF/2) break; 
} 

| waveInStart(hin) ; 


return Q; 


postponed. Next we create the two threads mentioned previously, namely 
Processthread and Buf ferThread, together with the two events that will 
be used to awake them from the idle status when we will need their serv- 
ices, ie InBufferReady and OutBufferReady. Here too we make sure 
that everything went well, aborting if not. As a final touch, we modify the 
priority of the two threads to make them ahead in the Windows scheduling 
queue. This helps to prevent interruptions and choppiness in the sound 
output. 

Weare now at the end of the initialisation process; we just have to crank 
up the sound subsystem, which is composed of the playback and the input 
parts, running independently. The playback part starts automatically as soon 
as it has been initialised (we will do it in the SoundStartOutput routine, 
described later), while the input part waits for a specific command. We take 
advantage of this in a way to not cause buffer starvation, which is what 
happens when the sound card has just digitised a new chunk of audio, but 
there are no free buffers to store it in, or the playback portion of the sound 
card has finished playing back a buffer and is asking for a new one, but 
there are none ready. To avoid that, the audio buffers are marked using the 
dwuser field, a field not used by Windows, but left to the user. We put in 
this field the value of 0 (zero) to indicate that this particular buffer is free, a 
value of 1 to indicate that it has been filled with audio contents, and a value 
of —1 to indicate that it has been put into the playback queue, ready for 
when Windows asks for a new output buffer. 

Returning to our code, we enter into a whi le loop which will be exited 
only when at least half of the output buffer is free, having been played back. 
The output buffers are primed with a content of 0 (zero) which corresponds 
to silence. So, while the second half of the output buffers is being played 


Table 10.5 (continued) : 


i 
| 
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Table 10.6 


i case WM_COMMAND : 
7 = LOWORD (wParam); 
k i ee Maan Cece sb dry @ A ha 


button[i].enabled = FALSE; 
button[k].enabled = TRUE; 


Enablewindow(hwndeutton[i], FALSE); 
Enablewindow(hwndButton[k], TRUE); 


Hz50 'button[0].enabled; 
Active = !button[2].enabled; 


wsprintf(msg, "HUMID is now in %s mode", Active ? "filter" : 


“bypass") ; 
if (Active) 
{ strcat(msg, ", tuned at "); 
strcat(msg, Hz50 ? "50 Hz" : "60 Hz"); 
} 
else strcat(msg, " Ds 


hdc = GetDC (hwnd) ; 

SelectObject (hdc, GetStockobject (SYSTEM_FIXED_FONT)) ; 
TextOut (hdc, 4 * cxChar, cyChar, msg, strlen(msg)) ; 
ReleaseDC (hwnd, hdc) ; 


return 0; 


back, we fill the first half with new audio data. To do this, we explicitly start 
the input part of the sound subsystem using the API waveInStart when 
we exit from that while loop. Having done this, the initialisation is com- 
pleted, and we return with a return code of zero to Windows. This ends the 
management of the WM_CREATE case of the switch clause. 

The next message to manage is the WM_COMMAND one (Table 10.6). Win- 
dows sends us this message when the user is interacting with our programme, 
in this case by clicking on a pushbutton with the mouse. 

Sending us a WM_COMMAND message is not enough, of course. We need to 
know at the minimum which button has been clicked. Looking carefully at 
the parameters passed to our window procedure, you will see wParam and 
1Param. This latter contains the handle of the child window clicked. I told 
you that everything is a window, buttons included. The windows contained 
in the main window are aptly named child windows, as they inherit some 
characteristics from the parent window, and are automatically closed when 
the parent window closes. The child window handle is the value that Win- 
dows returns from the CreateWindow call. But in this programme we won’t 
make use of this handle, as there is more useful information passed into the 
wParam parameter. This is a 32-bit value, split into the low- and the high- 
word parts. 

The high-word part carries the so-called notification code, which tells what 
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has been done with the button. There is not much else that can be done 
with a button, apart from clicking it, so this word will contain always the 
value of 0 (zero), corresponding to the manifest constant BN_CLICKED, de- 
fined by the windows .h header. The low word has the ID of the specific 
button that has been pressed. This ID is the value passed to Createwindow 
when the child window was created, the 9th argument of the call, the vari- 
able i, which was a zero-based index, ranging from 0 (zero) to 3. We use 
this ID to perform the correct function for the button clicked, and also to 
modify both the logical and the physical status of that button. What I mean 
with this is that, once pressed, the button must be greyed out to indicate 
that it cannot be clicked a second time, while the other one must now be 
enabled. For this we use one of those dirty tricks that non-orthodox pro- 
grammers like me love: 


aay ys liaer  falAEN ppcont ie ES 


In the above statement we compute the index k of the button paired with 
that pressed: i can assume the values 0, 1, 2, 3 - what we want is that if 1 = 
0, then k = 1 and vice versa, if i = 2 then k = 3 and vice versa. Instead of 
using a boring sequence of if statements, this can be elegantly accom- 
plished with the single statement above. Now we can use the indexes 7 and 
k to modify the status of our buttons, and to set a couple of Boolean vari- 
ables, namely Hz50 and Active which will be used later on, when actually 
doing the filtering. We are almost finished with the WM_COMMAND case — we 
just put on the screen a message telling the user what the present status of 
the filter is. The main API used for this is TextOut preceded by the selec- 
tion of the system fixed font used for writing the string. You can look up 
these APIs in the reference book. 

There is an important point to remark here, in case you missed it. We are 
in the message-processing loop of our programme, where responsiveness 
to user input is of utmost importance. We cannot afford to perform lengthy 
processes here. What we in the end do when the user clicks a button is just 
to set a couple of Boolean variables, which will then be examined by asyn- 
chronous processes (threads). Keep this in mind, follow this rule, and your 
first step towards user-friendliness is done. 

Now for the WM_PAINT and WM_CLOSE cases (Table 10.7). The WM_PAINT 
is the message that Windows sends us when there is a need to redraw the 
client area of the window. In the case of this programme it is quite simple, 
as there is just one thing that we have to refresh on the screen upon Win- 
dow’s request, ie that string showing the filter status, which was dynami- 
cally built by us in response to the WM_COMMAND message. The four buttons 
are child windows that do not have a client area, so Windows takes care 
itself of refreshing them. So what we have to do is just to acquire a device 
context handle (our virtual painting canvas) by calling the BeginPaint 
API, reuse the same TextOut API that we used in the WM_COMMAND case, 
and finally release the device context handle with EndPaint. That’s all. It 
would have been more complicated had ours been a graphical programme, 
maybe with layer support. 
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Table 10.7 


case WM_PAINT : 


hdc = BeginPaint Chwnd, &ps) ; 

SelectObject (hdc, GetStockObject (SYSTEM_FIXED_FONT)) ; 
TextOut (hdc, 4 * cxChar, cyChar, msg, strlen(msg)) ; 
EndPaint (hwnd, &ps) ; 


return 0 ; 
case WM_CLOSE : 


PostQuitMessage (0) ; 
return O ; 


The final case is WM_CLOSE. This message is sent by Windows typically 
when the user clicks on the small x-shaped icon at the upper right corner of 
the window. Windows politely asks us to terminate, please, giving us the 
chance to perform termination tasks, if need be, like releasing resources, 
closing files etc. When we are ready to end the instance of our existence in 
the current Windows session, we communicate this decision of ours by 
using the PostQuitMessage API. The PostQuitMessage function posts a 
WM_QUIT message to the thread’s message queue and returns immediately; 
the function simply indicates to the system that the thread is requesting to 
quit at some time in the future. As previously explained, a WM_QUIT mes- 
sage causes the GetMessage API to return a 0) (zero) value, thus exiting the 
whi le clause and bringing the life of the programme to an end. Note that, 
if you do not call the PostQuitMessage function, your programme does 
not terminate, regardless of how vehemently the user is clicking on that x- 
shaped icon, but don’t then complain if yours won’t be deemed an user- 
friendly programme! 

We have finished examining the switch construct, which has no default 
case. So, when we receive from Windows a message not explicitly managed 
by us, we just pass it back to the default procedure of Windows that takes 
care of unmanaged messages: 


return DefwindowProc Chwnd, iMsg, wParam, |IParam) ; 


And with this we have completed our window procedure, where we handle 
the messages originated by Windows, typically in response to user actions. 
What remains is the sound card initialisation and handling, and the actual 
comb filter code. We examine them in the next sections. 


The sound card 

You may recall that in the WM_CREATE case we encountered the two calls 
SoundOpenInput and SoundOpenOutput which weren’t described in de- 
tail at that moment. We will do it now. SoundOpenInput does nothing 
more than calling SoundStartInput and checking its return code, alerting 
the user if something went wrong. In computer programming jargon, this is 
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called a wrapper function. You will likely find this word again, should you 
further pursue your Windows programming adventure. 

Before delving into the sound card code, maybe a few words on the gen- 
eral architecture of sound recording and playing back are in order. Win- 
dows has two major systems for audio management. The first is called DirectX. 
You surely have already heard of it already. DirectX is a component (op- 
tional in some versions of Windows) meant for generally managing multi- 
media contents such as audio, video, animations, images and the like. The 
second is the WMME, which stands for ‘Windows Multimedia Extensions’, 
and it is standard in all versions (as far as I know) of Windows, from ’95 up. 

I generally use this latter system. Why? Well, DirectX perhaps has a 
lower latency time (the time elapsed between the moment you give a buffer 
to Windows to play back, and the moment you actually hear it from the PC 
speakers), but has some drawbacks. First, you (the developer) do not have 
the absolute guarantee that DirectX is installed on the user’s PC, so you 
must provide an installation procedure for it, just in case. Second, Microsoft 
from time to time releases new versions of DirectX, which do not always 
maintain a full compatibility with the older versions. In my modest opinion 
these two drawbacks outweigh the small advantage in terms of latency time. 
Just a personal opinion, of course. I tested DirectX, but wasn’t overly im- 
pressed by it. To be honest, it does have another advantage, ie with DirectX 
you can share the sound card with other applications running simultane- 
ously on the PC, but with the advent of the AC97 standard (more on this 
would be beyond the scope of this chapter) you can do the same with WMME 
too. 

So, having chosen WMME, how are they used? Conceptually, it is very 
simple. You open the input (or output) device, allocate a few buffers, pass 
them to the WMME, and you are done. When a new input buffer is ready, 
or there is a need for another output buffer to be played back, Windows 
interrupts asynchronously the flow of the programme in one of the various 
ways that you have specified during the open routine. The simplest one, 
which I have used here, is the so-called Callback Procedure, which is a rou- 
tine called directly by the inner Windows thread belonging to WMME. A 
word of caution here: this routine is executed as part of the system WMME 
thread, so you are a bit restricted as to what you can do here. The safest way 
is to copy the data, set flags if need be, and just return to the caller. 

Let’s now look into the SoundStartInput routine (Table 10.8). The first 
thing done here is to be sure to have at least one MCI device ((MCT’ stands 
for ‘Media Control Interface’, in other words we check if a sound card is 
present and correctly installed), using the waveInGetNumDevs API, then 
we set a few fields of the WAVEFORMATEX structure, used subsequently by 
the open function. Specifically, we set the number of channels, | in this 
case as we are not interested in stereo, the format of the data which is the 
standard PCM (pulse coded modulation, the normal uncompressed WAV 
format) and the sampling rate, which, for this application, is 44100 samples 
per second. We use the maximum sampling rate supported by the sound 
card, as the tracking algorithm of the comb filter works better the more 
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Table 10.8 


| MMRESULT SoundStartInput (void) 
if 
int: 13 

MMRESULT jierr; 
WAVEFORMATEX wf; 


// first check that we have at least *ONE* MCI device 


nDeviIn = waveInGetNumDevs() - 1; 
if (nDevIn < 0) return 1; 


ZeroMemory (&wf , sizeof (wf) ) ; // clear the structure with 0 
wf.wFormatTag = WAVE_FORMAT_PCM; 
wf.nchannels = 1; 
wf.nSamplesPerSec = srate; 
wf.wBitsPerSample = (WORD) (8 * nByteIn); , 
wf.nBlockAlign = (WORD) ((wf.nChannels * wf.wBitsPerSample) >> 3); 
wf .nAvgBytesPerSec = wf.nSamplesPerSec * wf.nBlockAlign; 
wf.cbSize = 0; me: 
jerr = waveInOpen((LPHWAVEIN)&hin, WAVE_MAPPER, (LPWAVEFORMATEX) wf, 

(DWORD)SoundProciIn, OL, CALLBACK_FUNCTION) ; 
frequently it receives data to act upon. We set also the number of bits for 
each sample which, for PCM, is 16. Each sample ranges from —32768 to 
32767, the value of 0 (zero) representing silence. 

During audio manipulation it’s usually more convenient to work with 
floats to minimise rounding and ranging errors, and this can be done by 
converting shorts (the 16-bit values) to floats and back again just before 
playing them back. However, this is not necessary in Humid as there are no 
computations (like FFTs) that could benefit from an extended dynamic range, 
so we will deal directly with short integers, as passed from the WMME. 

It’s now time to actually open the input stream of audio. The API used 
for this is waveInOpen, to which we pass, amongst other parameters, the 
address of the callback procedure SoundProcin that WMME will call each 
time a new input buffer is filled with audio data. Good programming habits 
dictate that a check is done on the return code from waveInOpen, to see 
whether everything went well. I don’t repeat here the details of the code 
(you can see it in Table 10.14) but in a nutshell we simply check for various 
error codes, displaying the appropriate error message should one of those 
happen. If everything is fine, it’s time to give some buffers to the input 
audio subsystem. Those buffers are allocated statically in this programme, 
but other applications may prefer to allocate them dynamically, perhaps of 
size and number determined at run time, based on the sampling rate speci- 
fied by the user and generally by other requirements. When buffers are 
given to the WMME, they must be prepared, more technical jargon which 
means that Windows must prime their headers with some initial informa- 
tion. The code is shown in Table 10.9. 

What we do is simply to initialise the user fields of the headers with pointers 
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Table 10.9 


for(i=0; i<NINBUF && ierr == MMSYSERR_NOERROR; i++) 
{ 
, ZeroMemory (&inhdr[i],sizeofCinhdr[i])); 
ZeroMemory(inbuf[i],BUFSIZE * nByteIn); 
inhdr[i].lpData = (char *) inbuf[i]; 
inhdr[i].dwBufferLength = BUFSIZE * nByteIn; 
/* The Length must be in bytes*/ 
inhdr[i].dwBytesRecorded = 0; 
inhdr[{i].dwuser = 0; 
inhdr[i].dwFlags = 0; 
inhdr[i].dwLoops = 0; 
inhdr[i].1lpNext = NULL; 
inhdr[i].reserved = 0; 
| //first prepare the waveheaders 
jerr = waveInPrepareHeader(hin, &inhdr[i], sizeof(wAVEHDR)); 
//second add the buffers to the MMAPI queue 
| jerr += waveInAddBuffer(hin, &inhdr[i], sizeof(WAVEHDR)); 
ee ee 
to the actual buffer space and to set a few flags, amongst which is the dwUser 
field mentioned before, used to keep track of current status of that particu- 
lar buffer. Nothing fancy here, just normal administration. Windows also 
has its fields to prime, as said before, and we let it do that by calling the 
waveInPrepareHeader API. Last step is to actually pass those buffers to 
the WMME with the waveInAddBuffer API. This call should return 0 
(zero) if all is well, so to make things simpler, we just add the return codes 
inside the loop for each buffer and we test at the exit of the loop if the sum 
is zero. We are not interested in knowing which (if any) of the calls failed. 
And practically this call doesn’t ever fail. Now everything is ready; we just 
have to start up the input side of audio management, and this is done by 
calling the function waveInStart which you may recall we have already 
encountered in the WM_CREATE case of our window procedure. 

The output part of audio handling is practically the same as the input 
part, and it is implemented in the SoundStartOutput routine. Of course 
wavernopen will become waveOutOpen and so on. But one difference is to 
be remarked. Here we stop the production of output using waveOutPause 
just after the opening, and we resume it later on, after having passed all the 
output buffers to the WMME, by using the waveOutRestart API. This 
because the playback doesn’t need to be started up manually — it starts 
automatically as soon as the waveOutOpen is issued. 

Fine, the engine is started and buffers are happily flowing in and out. 
How do we manage them? If you remember, we specified our desire to use 
callback functions for this purpose. These two functions are SoundProciIn 
and SoundProcout. Let’s look at them (Table 10.10). 

The routine is really simple. We test why it has been called: whether 
during open/close, or for a new buffer ready. In this latter case it in turn 
calls ProcessBuffer, which is shown in Table 10.11. 

Here the newly arrived buffer, pointed to by the field 1pData of the 
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Table 10.10 


/ VOID CALLBACK SoundProcIn(HWAVEIN hwi, UINT iMsg, DWORD dwinst, 
DWORD dwParaml, DWORD dwParam2) 


ete 
| switch(iMsg) 
i 
i case WIM_DATA: 
) if(!Inclosing) 
{ 
ProcessBuffer((LPWAVEHDR) dwParam1) ; 
} 
break; 
case WIM_OPEN: // Message sent when input device is opened 
sndInOpen = TRUE; 
break; 
case WIM_CLOSE: // Message sent when input device is closed 
sndInOpen = FALSE; 
break; 
} 
| } 


Table 10.11 


void ProcessBuffer(LPWAVEHDR ibuf) 


{ 
memcpy(tmpbuf, ibuf->lpData, BUFSIZE * sizeof(short)) ; 
SetEvent (InBufferReady) ; ¥ 
FilterQ; 
SetEvent (OutBufferReady) ; 
| 


structure iBuf (the buffer header), is copied into a working buffer, then an 
event is set to awake the ReQueBuf fers thread, whose task is to put that 
buffer again in the input queue, ready for new audio contents. Why do we 
need to have a thread dedicated to this? Couldn’t have we done that di- 
rectly in the ProcessBuffer routine? The answer is, unfortunately, no. If 
_ you remember, I told you that the callback procedure is executed as part of 
the WMME thread, and some APIs are not permitted here. 
waveInAddBuf fer is one of them, so we have to resort to raise a flag that 
will ask for the services of a different thread to put again that buffer into the 
input queue. A word of caution here: Windows 95/98 is rather tolerant. It 
lets you issue that call inside the callback procedure without complaining 
and the programme will even work. But don’t try to execute such a pro- 
gramme under Windows 2000 or Windows XP - failure is guaranteed. 
Besides raising the InBufferReady flag, we do a couple of other things. 
The actual filtering is done here by calling the Fi Iter function. This seems 
to contradict what I said earlier, that a minimal amount of work is to be 
done inside the callback procedures. As a matter of fact, the comb filter 
doesn’t consume a lot of processing power. I measured roughly 10% of a 
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Table 10.12 


void Filter(void) 


aoe | 
ifC(NULL == (newoutBuffer = GetFreeoutBuffer())) return; / 
if(Active) ApplyComb(tmpbuf, Hz50 ? 50. : 60.); | 
memcpy (newOutBuffer->lpData, tmpbuf, BUFSIZE * sizeof(short)); / 

} ; 
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750MHz Athlon CPU, so it’s safe to put the filtering code executed as part 
of the WMME thread. Things would be different in case of CPU-intensive 
processing code. In such a case, the safest bet would be to dedicate a spe- 
cific thread to that task, again using a SetEvent call to signal it that it has 
work to be done. This is the technique I used, for example, in the pro- 
gramme Spectran that I distribute on the Internet. The Filter function is 
very simple (Table 10.12). 

Here we first get a free output buffer from the free buffers pool by calling 
the GetFreeoutBuffer function. Then the ApplyComb (the real filtering 
code) function is called but only if the Active Boolean variable is set. You 
may recall that we set or reset this variable in response to the user action of 
clicking one of the two buttons (‘Bypass’ or ‘Activate’) on the main window 
of Humid. The filtering is done in-place, which means that audio data are 
passed in tmpbuf, and from the same buffer they are retrieved. So we can 
safely copy that tmpbuf into the previously acquired free output buffer, 
without caring if the comb filter has actually been applied. Pressing the 
‘Bypass’ button has the effect of copying the input buffer to output, un- 
changed, which is exactly what we wanted to do. 

Exiting from Filter we go back to the last statement of the 
ProcessBuffer function, called by the input callback procedure, where 
we just set a flag for the output queuing thread OutputAudio which simply 
scans the output buffers pool and queues to the output part of the WMME 
all of the buffers that have the dwuser flag (remember that?) set to 1, which 
means “filled, but not queued yet”. The flag is changed to —1 to indicate 
that the queuing has been now done. Again, we need to resort to a separate 
thread for the same reasons mentioned above. : 

Turning now to the output callback procedure SoundProcoOut, what we 
do here is really simple (Table 10.13). 

This procedure is called when an output buffer has been played back, and 
it is passed the address of that buffer. All we have to do is to set the dwUser 
flag of the buffer to 0 (zero), to return that buffer to the free output buffers 
pool. That’s all. We don’t need to feed here the output engine with new 
output buffers — this task, as we have already seen, is done just after the comb 
filtering. As soon a new output buffer is filled with new audio data, it is 
queued for playback. In this way we minimise the risk of buffer starvation. 

This concludes the description of sound card management in Humid. In 
the next section we examine briefly, as delving into DSP algorithms is not 
the purpose of this chapter, the comb filter code that performs the actual 
hum removal from the audio signal. 
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Table 10.13 


' VOID CALLBACK SoundProcout(HWAVEOUT hwo, UINT iMsg, DWORD dwinst, 
DWORD dwParam1, DWORD dwParam2) 


{ 
switch(iMsg) 
{ 
case WOM_DONE: 
if C!outclosing) 
{ 
(CLPWAVEHDR) dwParaml)->dwUser = 0; 
} 
break; 
case WOM_OPEN: // Message sent when output device is opened 
sndoutOpen = TRUE; 
break; 
case WOM_CLOSE: // Message sent when output device is closed 
sndOutOpen = FALSE; 
break; 
P 
pee 


The comb filter 


The comb filter belongs to a category of digital filters that are easy to imple- 
ment in the time domain, consume few resources and are very effective in 
doing what they are designed for. They belong to the class of FIR (finite 
impulse response) filters, which is jargon meaning that to compute the Nth 
filtered output sample you combine somehow the Nth input sample and 
some of the previous samples, going back as long as the order of your filter 
dictates. They are called ‘finite impulse response’ because there is the guar- 
antee that when the input goes to zero, so will do the output signal in a finite 
time, which depends on the order of the filter. This is to be contrasted with 
the IIR (infinite impulse response) filters, which use also some of the previ- 
ous outputs to compute the current one. For IIR filters the guarantee of 
having eventually zero output with zero input does not hold, given the 
method of computation of the current output. 

Paul Nicholson, the author of the original routine from which the comb 
filter of Humid has been adapted, has written the following notes about its 
filter. 


“This filter copies the sound card input to the output, tenaciously following 

the line frequency hum with a deep notch. When properly set up, the har- 
monic components of foreground hum should almost all the time be com- 
pletely inaudible at 16-bits dynamic range. 

“Comb filtering is very effective at removing the harmonic components 
of line frequency interference. By subtracting a delayed version of the sig- 
nal from the original, any incoming frequencies which are periodic in the 
delay time are completely notched out. The frequency width of the notches 
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is fairly wide and produces a noticeable drainpipe effect on the sound. By 
combining the output of multiple delay stages, this effect is considerably 
reduced and a much more natural sound is produced. 

“Sharpness of the multiple stage notch necessitates accurate tracking of 
the varying line frequency (typically wandering by up to +0.5%) to ensure 
that the line harmonics remain in the deepest point of the notches. This can 
be done by using the delay buffer and summing function to generate a 
three-point period-gram, which is used to steer the delay time towards that 
which gives maximum output from the summing function, and therefore 
the deepest notch. 

“The depth of the notches and the tightness of the period lock enable the 
harmonic components of foreground hum to be removed almost completely. 
The programme uses linear interpolation when drawing samples from the 
delay buffer, which improves the accuracy of the notch for those delay 
times. 

“Comb filtering works by subtracting a delayed version of the input sig- 
nal from the original. Signals which are periodic in the delay time are there- 
fore notched out and this gives a comb-like appearance to the resulting 
spectrum. With a single delay stage the notches are fairly wide, which gives 
an unpleasant ‘drainpipe’ colouration to the signal. 

“However, by taking multiple delay stages in cascade, averaging their 
outputs, and subtracting this average signal from the original, a much sharper 
notch is obtained. This reduces the drainpipe effect and with five or six 
stages the signal is quite pleasant to listen to. The downside is that with the 
much sharper notches, it becomes necessary to frequently adjust the filter 
stage delay in order to track the wandering frequency of the mains supply. 
This implementation uses a simple feedback loop to maintain track of the 
mains period. 

“The tracking works by running a couple of ‘trial’ filters at periods adja- 
cent to the real filter period. If either of these filters does a better job of 
removing hum, the tracking algorithm adjusts the real period towards that 
of the better performing trial. 

“The output from the comb_sum function provides a convenient way to 
determine which of the three trial periods offers the best filter. The function 
is called three times, once for each period, and each of the outputs is aver- 
aged. The trial with delay period closest to that of the incoming hum will 
give the highest average output because the input signal will be less coher- 
ent in the other two delay periods. 

“The tracking algorithm needs to decide how far and how quickly to 
change the filter period in response to the varying outputs of its trial filters. 
It also needs to decide at what delay periods the trial filters should run, ie 
how far are they to be displaced from the ‘real’ period. The tracking will try 
to move these trial filters around as necessary for best results, so really there 
are three filters being tuned, not just the one! 

“Some fairly ad hoc heuristics are employed and there is plenty of room 
for the experimenter to improve its performance. 

“Sometimes the tracking can be upset by impulse noise, and this effect 
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can be reduced by integrating the three comb_sum outputs, as shown in the 
example programme. This de-emphasises the higher-frequency signal com- 
ponents and can make for more stable tracking. However, if the input sig- 
nal consists of mainly higher-frequency hum components (eg the signal has 
already passed through some high-pass filter) then it might be necessary to 
disable the integration of the comb_sum outputs in order to obtain reliable 
tracking. 

“The delay stages are constructed from an array of signed 16-bit integers 
arranged as a circular buffer. The length of the buffer is rounded up to a 
power of two so that we can just use a bit-wise AND to cycle the pointers. 

“Linear interpolation is used in the comb_sum function. This enables the 
delay to be adjusted to a fraction of a sample period, and makes for a fairly 
good notch even when the delay period is not spanned by an integer number 
of samples. More sophisticated interpolation might improve performance, 
but the simple linear interpolation is fast and should be adequate for most 
applications. 

“Caveats and tips in no particular order: 


° Delay tracking doesn’t work for less than two stages. 


° This type of filtering will only remove harmonic components of the fore- 
ground hum. Non-harmonic components can be a real problem, espe- 
cially with signals from H-field antennas. Other techniques must be used 
to deal with these. 


° It is vital to ensure that foreground hum does not clip anywhere in the 
receive path upstream of the sound card, and that the sound gard mixer 
gain setting is such that the signal does not go out of range on the A/D. If 
overloading is allowed to occur, the hum cross-modulates with the noise 
to produce a broad spectrum of interference which cannot be removed. 


* When dealing with foreground hum, 16-bit mode is preferable. If using 
eight-bit mode and the hum is 10 times louder than the signals, the re- 
maining dynamic range after filtering is only five bits worth. 


¢ Inthe event that the input hum is so weak that the filter can’t recognise it, 
it will probably slew to one of its end stops and sit there harmlessly. 


¢ When running with 10 or more stages, the filter can lock onto one of the 
dips in the pass-band ripple. This occurs if the filter is started from cold 
and the line frequency happens to be a long way from its nominal value. 
Usually after a few seconds the filter finds the correct notch. 


¢ The ultimate depth of the notch is determined by the accuracy with which 
the outputs of the delay stages can be summed, which improves with 
increasing sample rate and increasing number of stages. 


¢ There isn’t much audible benefit in going beyond four or five stages.” 


I don’t think it is necessary here to go step by step into the actual comb 
filter code and show it in a detailed fashion. Just a few points: the routine 
SetupComb is called during initialisation to allocate buffer memory and set 
some global variables. It is never called again. The actual filtering is per- 
formed by ApplyComb, to which are passed both the current input audio 
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buffer composed of 512 audio samples, and the current setting of the funda- 
mental frequency to be removed (50 or 60Hz). This because some param- 
eters must be changed when this frequency changes. Filtering is done in- 
place, meaning that the contents of the input buffer are replaced by the 
filtered version. 

A further note about the leaky_integrate function. It has been found 
that in some cases, the filter works better without this integration. It de- 
pends on the ‘flavour’ of the hum and also the amount of impulsive noise 
present too. It could be worthwhile to do some experiments disabling this 
function to check if the working of the filter is improved. 

The function is easily disabled by replacing: 


*qa = (*a + val) * 0.999; 
with simply: 


*a = Vale 


Conclusions 


Well, we are the end of our journey into your first Windows programme. It 
is unlikely that you feel satisfied — either you will think that my description 
is too detailed or too brief. For those belonging to the first group, I can say 
that probably your knowledge of Windows is more advanced than that 
supposed for the intended audience of this chapter, and may be you wasted 
some of your time reading here. To the second group I can say that I sym- 
pathise with you, as I do remember quite well all of my problems when first 
trying to ‘tame the beast’, and was in search of all the information that it was 
possible to find. However, as I have already said a few pages back, going 
into much more detail would have meant to expand this chapter beyond its 
allotted limits, with the added risk of producing a poor replica of the Petzold 
book, which I recommend here once more. 

In Table 10.14 on the following pages you will find the entire source 
code of Humid, which you will also be able to download, complete with an 
already compiled executable, from reference [3]. 


References 
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Table 10.14. Complete source code listing for HUMID 


| File : Humid.h 
#include <windows.h> 
#include <mmsystem.h> 
| #include <stdio.h> 


#define RATE 44100 

#define BUFSIZE 512 

#define OUTBUFS 512 

#define NINBUF 8 

#define NOUTBUF 32 

#define BYTEIN 2. 

#define BYTEOUT 2 

#define ERRLEN 120 

#define NUM (sizeof button / sizeof button[0]) 


static void ProcessBuffer(LPWAVEHDR ibuf); 

static void fatal(char *); 

static void Filter(void); 

static LRESULT CALLBACK WndProc (HWND, UINT, WPARAM, LPARAM) ; 


static BOOL SoundOpenInput(void) ; 

static BOOL SoundOpenOutput (void) ; 

static void SoundCloseInput(void) ; 

static void SoundCloseOutput (void); 

static void SoundStopInput (void) ; 

static void SoundStopOutput (void) ; 

static MMRESULT SoundStartInput (void) ; 

static MMRESULT SoundStartOutput(void); ¥ 


static VOID CALLBACK SoundProcIn (HWAVEIN , UINT , DWORD, DWORD, DWORD ); 
static VOID CALLBACK SoundProcout (HWAVEOUT , UINT , DWORD, DWORD, DWORD ); 
static DWORD WINAPI ReQueBuffers(LPVOID) ; 
static DWORD WINAPI OutputAudio(LPVOID) ; 


extern void ApplyCcomb(short*, float); 
extern int SetupComb(void); 


static LPWAVEHDR GetFreeOutBuffer (void) ; 


File : Humid.c 


ep HUMID.C — Hum Instant Destroyer 
Tipe Alberto di Bene I2PHD, i2phd@weaksignals.com 


Sif Comb Filter code borrowed from 
Hyd Paul Nicholson, paul@abelian.demon.co.uk 


#include "humid.h" 


struct 
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Table 10.14 (continued) 


long style ; i 
char *text ; | 
| BOOL enabled; 
} button[] = 


HWAVEIN ~— hin; 

HWAVEOUT ——hout; 

WAVEHDR inhdr[NINBUF], outhdr[NOUTBUF] ; 
RECT FeCt, -SECreen:: 5 


{ 

BS_PUSHBUTTON, "SO Hz", FALSE, 
BS_PUSHBUTTON, "60 Hz", TRUE, 
i BS_PUSHBUTTON, "Activate", FALSE, 
BS_PUSHBUTTON, "Bypass", TRUE 
h; 
| BOOL Hz50 = TRUE, Active = TRUE; 

ity Ssrate = RATE; 

HWND hwnd; 
| HANDLE BufferThread, ProcessThread, InBufferReady, OutBufferReady; 
| 


int WINAPI WinMain (HINSTANCE hInstance, HINSTANCE hPrevinstance, 
PSTR szCmdLine, int iCmdShow) 


i { 

static char szAppName[] = “Humid" ; 

MSG msg ; 

j WNDCLASSEX wndclass ; 

: GetwindowRect(GetDesktopwindow(), &screen) ; 

rect. left = screen.right/2 - 250; 

' rect.top = screen.bottom/2 - 60; 

rect.right = rect.left + 500; 

rect.bottom = rect.top + 120; 

| wndclass.cbSize = sizeof (wndclass) ; 

wndclass.style = CS_HREDRAW | CS_VREDRAW ; 
~wndclass.IpfnwndProc = wndProc ; 

wndclass.cbClseExtra = 0% 

wndclass.cbwndeExtra =e: 

wndclass.hInstance = hInstance ; 

' wndclass.hIcon = LoadIcon (NULL, IDI_APPLICATION) ; 

| wndclass.hCursor = LoadCursor (NULL, IDC_HAND) ; 
wndclass.hbrBackground = (HBRUSH) GetStockObject (WHITE_BRUSH) ; 
wndclass.]pszMenuName = NULL ; 

' wndclass.|lpszClassName = szAppName ; 

| wndclass.hIconsm = LoadIcon (NULL, IDI_APPLICATION) ; 

i 

RegisterClassEx (&wndclass) ; 

| 

| hwnd = Createwindow (szAppName, " HUMID - Hum Instant Destroyer V1.2", 
: WS_CAPTION | WS_SYSMENU, 

i rect. left, rect.top, 

500, 120, ) 
Fee a ac as Et be BTS eS PMR bee ic BeB as BE SNe ea RR ae Re SSS EU a Re oA SND ee Ee! SONS aid ew Deir dea eS ee j 
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Table 10.14 (continued) 


//—- 


NULL, NULL, hInstance, NULL) ; 


Showwindow (hwnd, icmdShow) ; 
Updatewindow (hwnd) ; 


while (GetMessage (&msg, NULL, 0, 0)) 
{ 


TranslateMessage (&msg) ; 
DispatchMessage (&msg) ; 


return msg.wParam ; 


| LRESULT CALLBACK WndProc CHWND hwnd, UINT iMsg, WPARAM wParam, LPARAM 1|Param) 
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{ 

static char msg[128] = "HUMID is now in filter mode, tuned at 50 Hz"; 
Static HWND hwndButton[NUM] ; 

Statice ine cxChar, cyChar ; 


HDC hdc. 

PAINTSTRUCT ps ; 

int Ponks 

TEXTMETRIC ermine 

long style; 

DWORD thid1l, thid2; 

switch (iMsg) Pe 
{ 


case WM_CREATE : 

hdc = GetDC Chwnd) ; 

SelectObject (hdc, GetStockObject (SYSTEM_FIXED_FONT)) ; 

GetTextMetrics (hdc, &tm) ; 

cxChar = tm.tmAveCharwidth ; 

cyChar = tm.tmHeight + tm.tmExternalLeading ; / 
ReleaseDC (hwnd, hdc) ; : 


for (i = 0 3 71 < NUM ; i++) 


{ 
style = WS_CHILD | WS_VISIBLE | button[i].style; 
if(!button[i].enabled) style |= WS_DISABLED; 
hwndButton[i] = Createwindow ("button", button[i].text, 
style, 
exChar #7 a5e% 4% 254 reycharsen 37 
10. =. exChany 97) *eyeharts/ a4, 
hwnd, (HMENU) 7, 
CCLPCREATESTRUCT) 1Param) -> hInstance, NULL) F 
I 


if (C!Setupcomb()) // initialize the comb filter 
{ 
fatal("Unable to allocate filter buffers"); 
PostQuitMessage (1) ; 


case 
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Table 10.14 (continued) 


} 


if(!SoundOpenInputQ) || !Soundopenoutput()) 
PostQuitMessage (1) ; 


InBufferReady = CreateEvent(NULL, FALSE, FALSE, NULL); 
OutBufferReady = CreateEvent(NULL, FALSE, FALSE, NULL); 


BufferThread = CreateThread(NULL, 0, ReQueBuffers, 
OF sO. ethidiy 
Processthread = CreateThread(NULL, 0, OutputAudio, 
0, 0, &thid2); 
if(NULL == BufferThread || NULL == ProcessThread) 
{ 
fatal("Unable to create processing threads"); 
PostQuitMessage (1) ; 
} 


SetThreadPriority(BufferThread, THREAD_PRIORITY_HIGHEST) ; 
SetThreadPriority(Processthread, THREAD_PRIORITY_HIGHEST) ; 


// if everything ok so far, then tell MMAPI to start recording 
// but only when we will have plenty of free output buffers 


whi le (TRUE) 
{ for Ck=0; k<NOUTBUF; k++) 
ifCouthdr[k].dwUser != 0) break; 
1#(kK>=NOUTBUF/2) break; 
} 
wavelInStart(hin) ; 
return QO; 


WM_COMMAND  : 


= LOWORD (wParam); 


ats. 
I 


PGES AT Gp a DS el Gla cra to | Wa -tired @L dan ean 1) 
button[i].enabled = FALSE; 
= TRUE: 


button[k].enabled 


Enablewindow(hwndButton[i], FALSE); 
Enablewindow(hwndButton[k], TRUE); 


Hz50 !button[0].enabled; 
Active = !button[2].enabled; 


wsprintf(msg, "HUMID is now in %s mode", Active ? “filter” : 
"bypass") ; 


if (Active) 
{ strcat(msg, ", tuned at "); 
streatGnsg, 3HzZ50).27) "50 Hz": “60°Hz"):; 


3 
j 
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Table 10.14 (continued) 
} 


else strcat(msg, " ws 


hdc = GetDC Chwnd). ; 
SelectObject (hdc, GetStockobject (SYSTEM_FIXED_FONT)) ; 
} Textout (hdc, 4 * cxcChar, cyChar, msg, strlen(msg)) ; 
ReleaseDC (hwnd, hdc) ; 

return 0; 

case WM_PAINT : 

hdc = BeginPaint (hwnd, &ps) ; 
SelectObject (hdc, GetStockObject (SYSTEM_FIXED_FONT)) ; 
Hie TextOut (hdc, 4 * cxChar, cyChar, msg, strlen(msg)) ; 
EndPaint (hwnd, &ps) ; 
return O ; 


| case WM_CLOSE : 


PostQuitMessage (0) ; 
return 0 ; 


return DefwindowProc (hwnd, iMsg, wParam, IParam) ; 


UINT nByteIn=BYTEIN, nByteOut=BYTEOUT ; 
short *inptr; 


| LPWAVEHDR newOutBuffer; 
static int nDeviIn, nDevOut; 


static short inbuf[NINBUF][BUFSIZE], tmpbuf[BUFSIZE]; 
static short outbuf[NOUTBUF] [OUTBUFS] ; 


| static BOOL sndInOpen = FALSE, sndOutOpen = FALSE, OutClosing, InClosing; 
| ; 


BOOL SoundOpenInput (void) 
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{ 
MMRESULT ierr; 
~ char err[ERRLEN]; 
Inclosing = FALSE; 
jerr = SoundStartInputQ); 
if Cierr != MMSYSERR_NOERROR) 
{ 
if Gierr == 9) return FALSE; 
wavelInGetErrortext(ierr, (LPSTR) err, ERRLEN); 
MessageBox(NULL, err, “Audio input error”, 
MB_APPLMODAL | MB_OK | MB_ICONEXCLAMATION) ; 
SoundCloseInput() ; 
return FALSE; 
} 
return TRUE; 
} 
| [~-----=---=----------------------- -—- 
void SoundcloseInput (void) 
{ 
SoundStopInput() ; 
} 
] Ee -- 
T/ 
// These functions control opening and closing of the MCI device 
Be 
| [>----~------------------------------- 


MMRESULT SoundStartInput(void) 


antsas 
MMRESULT jierr; 
WAVEFORMATEX wf; 


// first check that we have at least *ONE* MCI device 


nDeviIn = waveInGetNumDevs() - 1; 
if (nDevIn < 0) return 1; 


ZeroMemory (&wf , sizeof (wf)) ; // clear the structure with 0 

wf .wFormatTag = WAVE_FORMAT_PCM; 

-wf.nChannels = 1; 

wf.nSamplesPerSec = srate; 

wf.wBitsPerSample = (WORD) (8 * nByteIn); 

wf.nBlockAlign = (WORD) ((wf.nChannels * wf.wBitsPerSample) >> 3); 
wf.nAvgBytesPerSec = wf.nSamplesPerSec * wf.nBlockAlign; 
wf.cbSize = 0; 


jerr = waveInOpen((LPHWAVEIN)&hin, WAVE_MAPPER, (LPWAVEFORMATEX) éwf, 
(DWORD)SoundProcIn, OL, CALLBACK_FUNCTION) ; 
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Table 10.14 (continued) 


switchCierr) 
{ 
case MMSYSERR_ALLOCATED : 
fatal("Windows reports that your Soundcard is already in use by another pro- 
gram"); 
return 9; 


case MMSYSERR_BADDEVICEID : 
fatal("Bad Soundcard Device"); 
return 9; 


case MMSYSERR_NODRIVER : 
fatal("No Soundcard driver!"); 
return 9; 


case MMSYSERR_NOMEM : 
fatal("Not Enough Memory for Soundcard") ; 
return 9; 


case WAVERR_BADFORMAT : 
fatal("Your Soundcard does not support this wave Format”); 
return 9; 


// Everything ok. Our device is opened and ready to start recording 
| // We pass all the available buffers to MMAPI 


for(i=0; i<NINBUF && ierr == MMSYSERR_NOERROR; 71++) = 
{ 
ZeroMemory (&inhdr[i],sizeofCinhdr[i])); 
ZeroMemory(inbuf[i],BUFSIZE * nByteIn); 
inhdr[i].lpData = (char *) inbuf[i]; 
inhdr[{i].dwBufferLength = BUFSIZE * nByteIn;/* The Length must be in bytes*/ 
inhdr[i].dwBytesRecorded = 0; 
inhdr[i].dwuser = 0; 
inhdr[i].dwFlags = 0; 
inhdr[i].dwLoops = 0; 
inhdr[i].1pNext = NULL; 
inhdr[i].reserved = 0; 
| //first prepare the waveheaders 
jerr = waveInPrepareHeader(hin, &inhdr[i], sizeofC(WAVEHDR)); 
//second add the buffers to the MMAPI queue 
jerr += waveInAddBuffer(hin, &inhdr[i], sizeofCWAVEHDR)); 


} 
if Cerr!=MMSYSERR_NOERROR) 
{ 
if(sndInOpen) waveInCclose(hin) ; 
fatal("Errors during In_Buffers prepare"); 
} 


return jerr; 
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Ent 1: 


InClosing = TRUE; // set this, or the threads will try 
// to write to an invalid handle! 

wavelInStop(hin); 

wavelInReset (hin) ; 


for(i=0; i<NINBUF; i++) 
waveInUnprepareHeader(hin, &inhdr[i], sizeofCWAVEHDR)); 
if(sndInOpen) wavelInclose(hin); 


VOID CALLBACK SoundProcIn(HWAVEIN hwi, UINT iMsg, DWORD dwInst, 


DWORD dwParaml1, DWORD dwParam2) 


switch(iMsg) 

i 

case WIM_DATA: 
if(!Inclosing) 


{ 

ProcessBuffer((LPWAVEHDR) dwParam1) ; 
} 
break; 


case WIM_OPEN: // Message sent when input device is opened 
sndInOpen = TRUE; 
break; 


case WIM_CLOSE: // Message sent when input device is closed 


sndInOpen = FALSE; 
break; 


| BOOL SoundOpenoutput (void) 


{ 


MMRESULT jerr; 
char err[ERRLEN]; 


OutClosing = FALSE; 


jerr = SoundStartoutput() ; 
if Cierr != MMSYSERR_NOERROR) 


i! 
ie Clerk ==39)- return) -FALSE: 


} 
j 
| 
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: waveOutGetErrortext(ierr, (LPSTR) err, ERRLEN); 
MessageBox(NULL, err, "Audio output error”, 
MB_APPLMODAL | MB_OK | MB_ICONEXCLAMATION) ; 
SoundCloseOutput() ; 
return FALSE; 


} 
return TRUE; 
} 
BY 5 lccnccrsmaeca nas Wick aca. 1 OR AEG EE EI 
| void SoundCloseOutput (void) 
bf 
i SoundStopOutputQ) ; 
| 3 
/ ae 
| MMRESULT SoundStartoutput (void) 
| t 
TNs 


MMRESULT ierr; 
| WAVEFORMATEX wf ; 
| // first check that we have at least *ONE* MCI device 


nDevOut = waveOutGetNumDevs() - 1; 
if (nDevout < 0) return 1; 


ZeroMemory (a&wf , sizeof (wf) ) ; /* clear the structure with 0*/ 

wf .wFormatTag = WAVE_FORMAT_PCM; ¥ 
wf.nCchannels = 1; 

wf.nSamplesPerSec = srate; 

wf .wBitsPerSample (WORD) (8 * nByteOut) ; 

wf.nBlockAlign = (WORD) ((wf.nChannels * wf.wBitsPerSample) >> 3); 
wf.nAvgBytesPerSec = wf.nSamplesPerSec*wf.nBlockAlign; 

wf.cbSize = 0; 


jierr = waveOutOpen((LPHWAVEOUT)&hout, WAVE_MAPPER, (LPWAVEFORMATEX) &wf, 
(DWORD)SoundProcout, OL, CALLBACK_FUNCTION) ; 


switch(ierr) 
{ 
case MMSYSERR_ALLOCATED : 
fatal ( 
"windows reports that your Soundcard is already in use by another program\r\ 
Please check if you did set fullduplex ON"); 
return 9; 


case MMSYSERR_BADDEVICEID : 
| fatal("Bad Soundcard Device"); 
return 9; 


Case MMSYSERR_NODRIVER : 
fatal("No Soundcard driver!"); 
Fetonrns 915 
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case MMSYSERR_NOMEM : 
fatal("Not Enough Memory for Soundcard"); 
return 9; 


| 
' 

: case WAVERR_BADFORMAT : 

fatalC"Your Soundcard does not support this Wave Format"); 
j return 9; 
i 

' 

| 

| 

| 

i 

j 

i 


} | 


| //the device starts playback immediately not like the recording device 
//which needs another command to start recording, so pause it initially. 


jerr = waveOutPause(hout) ; 

for(i=0; i<NOUTBUF && ierr == MMSYSERR_NOERROR; i++) 

{ ZeroMemory(&outhdr[i],sizeofCouthdr[i])); 
i ZeroMemory(outbuf[i],OUTBUFS * nByteOut); 
outhdr[i].]pData = (char *) outbuf[i]; 
outhdr[i].dwBufferLength = (DWORD) OUTBUFS * nByteOut; 
outhdr[i].dwBytesRecorded = OL; 
| outhdr[i].dwUser = -1; // -1 indicates : buffer queued 
outhdr[i].dwFlags = OL; 
outhdr[i].dwloops = OL; 
: outhdr[i].1pNext = NULL; 
| outhdr[i].reserved = OL; 
jerr = waveOutPrepareHeader(hout, &outhdr[i], sizeof (WAVEHDR) ) ; 
j } 


| // queue the buffers 
for(i=0; i<NOUTBUF && jerr == MMSYSERR_NOERROR; i++) 
jerr = waveOutwrite(hout, &outhdr[i], sizeof(WAVEHDR) ) ; 


if Cierr!=MMSYSERR_NOERROR) 
h 
ifCsndOutOpen) waveOutClose(hout) ; 
fatal("Errors during Out_Buffers prepare"); 
Pneturncl; 


} 


| 

t 

i 

| 

| jerr = waveOutRestart(hout) ; 
| return ierr; 
i 

| 


| void SoundStopOutput (void) 
{ 


int: 15 | 
OutClosing = TRUE; 


waveOutPause(hout) ; 
| waveoutReset (hout) ; 


for(i=0; i<NOUTBUF; i++) 
waveOutUnprepareHeader(hout, &outhdr[i], sizeof (WAVEHDR)) ; i 
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if(sndOutOpen) waveOutClose(hout) ; 


/ VOID CALLBACK SoundProcOut(HWAVEOUT hwo, UINT iMSg, DWORD dwInst, 
DWORD dwParaml1, DWORD dwParam2) 


be 
switch(iMsg) 
{ 
case WOM_DONE: 
if C!outclosing) 
tf 
(CLPWAVEHDR) dwParam1)->dwUser = 0; 
| 
break; 
Case WOM_OPEN: // Message sent when output device is opened 
sndOutOpen = TRUE; 
break; 
case WOM_CLOSE: // Message sent when output device is closed 
sndOutOpen = FALSE; 
break; i 
¥ 
} 
} 
| [~-==---=--- === === === === === 
void ProcessBuffer(LPWAVEHDR ibuf) 
{ ; 
memcpy(tmpbuf, ibuf->lpData, BUFSIZE * sizeof(short)); 
SetEvent (InBufferReady) ; 
FilterQ; 
SetEvent (OutBufferReady) ; i 
} 
| [222 
void fatal(char-* msg) 
{ 
MessageBox (hwnd, msg, Humid", MB_APPLMODAL | MB_OK | MB_ICONEXCLAMATION) ; 
} 
| [~~=2 === === == 
eye This is the buffer requeing thread, which cannot be done inside 
Hes the MMSYSTEM Callback procedure 


DWORD WINAPI ReQueBuffers(LPVOID param) 

{ 
int 13 
MMRESULT Jerr; 


while (CTRUE) 
{ 
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WaitForSingleObject(InBufferReady, INFINITE) ; 


for(i=0, ierr=0; i<NINBUF; i++) 
if Cinhdr[i].dwFlags & WHDR_DONE) 


! 
if(MMSYSERR_NOERROR != 
Cierr = waveInAddBuffer(hin, &inhdr[i], sizeof (WAVEHDR) ))) 
break; 
} 


| ifCierr != MMSYSERR_NOERROR) 

{ char s[128]; 

; sprintf(s, “Error during inbuffer requeing, code %d", ierr); 
' fatal(s); 
: 

; 


} 

} 

| 3 

Pee ee 

iS/ This is the audio processing thread, which requeues the filtered buffer 
Kae to the MMSYSTEM queue 

; 


| DWORD WINAPI OutputAudio(LPVOID param) 


ee 

' AE alos 

. while (TRUE) 

bes 

i waitForSingleObject(OutBufferReady, INFINITE); 
for(i=0; i<NOUTBUF; i++) 

if(outhdr[i].dwuser == 1) 

{ 

i waveOutwrite(hout, &outhdr[i], sizeof C(WAVEHDR)) ; 
outhdr[i].dwuser = -1; 

} 

} 

|e. 

LE ee eee 

void Filter(void) 

if 

if(NULL == (newoutBuffer = GetFreeOutBuffer())) return; 
} if(Active) Applycomb(tmpbuf, Hz50 ? 50. : 60.); 

memcpy (newOutBuffer->IpData, tmpbuf, BUFSIZE * sizeof(short)); 
[2 

| f [a 

| LPWAVEHDR GetFreeoutBuffer (void) 

bet 


| eis Kas 
for(k=0; k<NOUTBUF; k++) 
| _ifCouthdr[k].dwuser == 0) 
{ 
outhdr[k].dwUser = 1; 
return &outhdr[k]; 
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return NULL; 


| File : CombFilter.h 
| #define VERSION "1.2" 


* End stop. Maximum +/- percentage deviation from the nominal delay that 
* the tracking will be allowed to use. 

Bela 

| #define END_STOP 0.5 /* Percent */ 


ft 
| * Number of comb delay stages. 
oa 
#define DEFAULT_STAGES 4 


Ad 
Seconds between iterations of the line frequency tracking. 
ef 
#define DEFAULT_TRACKING_CYCLE 1 


* The default encoding, 8 means unsigned bytes, 16 means signed 16 bit words. # 
*/ 
#define DEFAULT_ENCODING 16 


* This constant sets the nominal slewing rate of the period tracking. This 

value gives stable locking under most conditions. The filter may lag when 
* a sudden shift occurs, if this happens too much, then raise the value, 

* eg to 0.02 or 0.04. If the filter jumps out of lock on bursts of noise, 
then reduce the value. i 


mf 

| #define SLEW_RATE 0.01 

| /* 

/ * Smoothing factor for the period tracking. Not very critical. 
bs | 


| #define COMB_SMOOTH 0.9999 


* Maximum tracking width. The max delay difference between the low and high 
* measurement periods, and the current delay period, units of samples. 
sea ; 

| #define MAX_TRACK 10 


/* 


End of tunable definitions. 


// 


static short 
static int 
static int 
static int 
static int 


static float 
static float 
static float 


static float 
static float 
static float 


static float 
‘Static float 
static float 


{, 
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extern BOOL Hz50; 


File : CombFilter.c 
#include "“Humid.h" 
#include “CombFilter.h" 
#include <math.h> 


*comb_buffer; 
comb_len; 
comb_1]p = 0; 
comb_mask; 


| 
t 
i 


j 


[ [BRE EER SER ERE ERE ERE REE RE EER BARA EE ER EERE E AER REEER RRR ALAR RER EARLE AH HARE HR 


The comb Filter 
f[ [BERR ERE RRRER EERE ERR ER ERERE ERR RE HERR KR EERE EERE REREKKRREARER RR EERERERAE ERE 


// Points to comb delay buffer 

// Total length of the comb delay buffer 

// Load offset into comb_buffer, next location to load 
// Mask for buffer offsets 


comb_stages = DEFAULT_STAGES; // The number of delay stages in use 


comb_delay; 


// Current comb delay, per stage, in units of samples 


comb_adj; // Incremental adjustment to comb delay 

max_delay, min_delay; // Allowed limits to comb delay | 
track_low = 0; // Low period accumulator 

track_mid = 0; // Middle period accumulator - current delay 


track_high = 0; 


tracking_width 
tracking_cycle 
nom_delay; 


int SetupComb (void) 


int 71, max_comb_len; 


max_comb_len = i; 


max_comb_len = 1 + MAX_TRACK * comb_stages + 
20.0 * comb_stages * RATE/1000. * (1+END_STOP/100.0); 


for @=1; 1 < max Jcomb_len;) 1. <<= 1; 


// High period accumulator 


1.0; // Offset in period space of the tracking guides 
DEFAULT_TRACKING_CYCLE; // How often to revise delay 
// nominal delay : 20 ms for 50 Hz, 16.666 for 60 Hz 


* Initialise the comb filter: allocate buffer memory and set some globals. 
* The buffer must be long enough for the max possible delay, plus an extra 
allowance for the high period tracking. Wwe then round up to the next 

* power of two for efficiency. 


if((comb_buffer = (short *) malloc( sizeof(short) * max_comb_len)) == NULL) 
{ | 
return 0; 
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return 1; 


// Comb summing function. Sum over the given number of delay stages, each 
// of length delay_steps samples. Use linear interpolation between samples. 


// At high sample rates, adequate results can be obtained without the linear 
// interpolation, which can save quite a bit of CPU time. 


/ static int __inline comb_sum(int stages, float delay_steps) 
Pes 

int ne; 

float f = 0, g = delay_steps; 


for( ne=1; ne<=stages; ne++, g += delay_steps) 


{ 
Antegh i=" gs 
Mite Pitat lahes 
p = comb_Ip - gf; 
f1 = comb_buffer[ p-— & comb_mask]; 
f2 = comb_buffer[ p & comb_mask]; 
FPS ee Ch2 hl) maiCo=g hs 
} ¥ 


return Cint)(f/stages + 0.5); 


static void adjust_delay(void) 
{ 
float f; 
float balance = track_high/track_low; /* Equals 1.0 when in tune */ 
float mean = track_high * track_low/track_mid/track_mid; 


if( balance > 1) comb_adj = 1; 


else 
{ 
comb_adj = -1; 
balance = 1/balance; 
} 


comb_adj *= f * SLEW_RATE/comb_stages; ; 
if( mean < 0.5) tracking_width /= 2; 

else 

if( mean > 0.8) tracking_width *= 2; 


f ='powG balance, 10)3 (1ECE S(10)> Fy = 700: 
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if( tracking_width < 0.1) tracking_width = 0.1; 
else 
if( tracking_width > MAX_TRACK) tracking_width = MAX_TRACK; 


Revise the delay, and constrain within the end stops. 
comb_delay += comb_adj * RATE/1000.0; 


if€ comb_delay > max_delay) comb_delay = max_delay; 
if( comb_delay < min_delay) comb_delay = min_delay; 


*a = *a * COMB_SMOOTH + val * (1-COMB_SMOOTH) ; 


This function is called with each signal buffer 
id Applycomb(short* inbuf, float freq) 


Static float pulow, = 04, pemid ="0., phigh = 70. 
static float oldfreq = 0.; 

static int count = 0; 

ints ieet, tg, +adxs 

Shortie os: 


if(freq != oldfreq) 


{ 
oldfreq = freq; 
nom_delay = 1000./freq; 
comb_delay = nom_delay * RATE/1000.0; 
max_delay = comb_delay * (1+END_STOP/100.0); 
min_delay = comb_delay * (1-END_STOP/100.0); 
comb_len = comb_stages * (1 + MAX_TRACK + max_delay); 
for Giels. Ti <-comb lent. )a <<="1: 
comb_len = 7; 
comb_mask = comb_len-1; 

} 


Process the incoming buffer, and keep track of the mean 
square and peak values. 


forCidx=0; idx<BUFSIZE; idx++) 
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: s = inbuf[idx]; 
comb_buffer[comb_lp] = s; // Store incoming sample in comb buffer 


// Run the comb summing function three times, for the low, high, and middle 
|// periods. Integrate each sum over time to give a 6db/octave roll-off. 
| // Then smooth the squared amplitudes of the integrated sums. 


t = comb_sum( comb_stages, comb_delay - tracking_width) ; 
leaky_integrate( &p_low, t); 
smooth_accumulate( &track_low, p_low * p_low); 


t = comb_sum( comb_stages, comb_delay + tracking_width) ; 
leaky_integrate( &p_high, t); 

smooth_accumulate( &track_high, p_high * p_high),; 

t = comb_sum( comb_stages, comb_delay); 

leaky_integrate( &p_mid, t); 

smooth_accumulate( &track_mid, p_mid * p_mid); 


// Revise the delay every tracking_cycle secs. 


if( ++count > RATE * tracking_cycle) 


{ 

| 

LEC track mid: l= 0) // Must have a non-zero input signal 
| { 

adjust_delay(); 

fect 


comb_lp = Ccomb_1p+1) & comb_mask; 
inbuf{idx] = s - t; 


224 


A 
A-law quantisation .... 152 
A/D converters ...... 114 
ALE (automatic link 
establishment ... 52 
Aliasing .. <ReRee . 150 
American Standard Code 
for Information 
Interchange...... 12 
AMTORRAGHS. SOR 2 
Analogue/digital 
conversion ..... 66 
72 Gd I 2 an fee aaa 190 
Applications software 5 
ASCLL Se eee coe ee 12 
Atmel AVR controller .. 78 
Automatic link 
establishment ... 52 
Automatic tuning and 
SCANNING su... of: 46 
Automatically set GPS 
ClOCISEE nse 143 
B 
Backing Up saver « ones 19 
Band-pass sampling ... 151 
Basic language ........ 1 
Baud rates ty 12 25 
BBC Computer ....... 1 
Binary coded decimal 
(BCD), od. eR 11 
Binary multiplication .. 109 
Bits: o.fa.d so eRe 2, 
DULCE < \5 cats ee Pah + 12 
(6, 
(lang UA Cele. pecosetane kote 8 
Callback Procedure ... 199 
@haractersa veer eae 12 
Child windows....... 196 
Circular buffers ...... 168 
Clientiarea: saris tee 192 


Extra resources for this book are at www.rsgb.org/books/extra/command.htm 


CODECS... hea. 150 
Comb filtesmepmecae: 204 
Command Prompt utility 3 
@ommanderhiasneer a 46 
Complex notation .... 156 
COM portincistseetive hf: 25 
Computer operating 

SYSLCINS 2 nai-eihi 
Computing, home ..... 1 
Converting code for the 

16628) Seen 144 
Correlation...... 158, 161 
Controller, hand-held 

low-poer) 2 je. 125 
Crashes... aeaeeee 18 
CW keyer programme. 33 
D 
D/A conversion ....... 72 
Data logying.; 5... 64 90 
Data modest. +. 22. 20 
Data-security is mtrr itt 18 
Decimatiouh. oe eet 169 
Delphi cccws,. shiney. 10 
Detecting signals in 

NOISE gristersieyona eave 47 
Device context ....... 193 
DEE ase aero cres.: 162 
IDIGTPAN Pe cee Dil 
Digital filtering ....... 167 
Digital signal 

processing... 20, 149 
IDineCO et oe eer 199 
Discrete Fourier 

{AanSfOsM ee 162 
ISplaysie ty. wert Se WD 
Division, binary ...... 118 
1S Pee terete 20, 149 

chips aps Mite Ant 173 
hardwarercn eon 173 


Dual-tone multifrequency 
(DTMF) signalling 99 
Dynamic range....... 151 


E 
| DHA OP rece cach Cney Sayin ter eli 39 
EScelteeeigen ce net 5 
F 
Fast Fourier transform 
(ERT) veces 162 
Filters 
COMDENGNS Hctonerse 204 
digital. 2.0.9 Ress 167 
SElIECH OME ta ie 130 


Finite impulse response 
(FIR) filters . 167, 204 
Floating point numbers . 17 


FM demodulation .... 157 
Frequency 
Dinka ee 48, 163 
CONVERSION re ee: 153 
measurement ...... 85 
G 
GOIAY programmable 
beacon keyer .... 81 
Game portyiciisas te 38 
General Public License 
(GPE. ree 4 
GPRS Ceeee eee meee 53 
clock, automatically 
Selva tern cata: 143 
locked frequency 
Stabliseness cre 137 
GWiBasieeeee ere 7 
H 
Hand-held, low-power RF 
controller. 2... 125 
Handlesmrmc. icon 190 
Harmonic sampling... 151 
Harvard 


architecture. 56, 174 
Hexadecimal numbers. . 11 
HF-08 data logger .. 6, 91 
Home computing...... 1 


Index 


225 


COMMAND - Computers, Microcontrollers and DSP for the Radio Amateur 


226 


Huff and Puff stabiliser 137 
ELUIMIND 3 eee eee 188 


I/O for microcontrollers 72 


VO samples. ci) 0s 155 
IARU beacon 
monitoring ...... 51 
IBM Personal Computer 2 
LER: cease iacn toe 166 
Infinite impulse response 
(IR) filter’. 22. 169 
Interfacing 
to the personal computer 
23, 63 
to the sound card under 
Windows....... 187 
to the transceiver .... 41 
ivierserh 1) ere archareatet 166 
LSA: DUSe Scores 29 
Isplationesa a0. eae 39 
J 
Joystick port . 55... 38 
L 
LCD modulesis.. ).45- 74 
LED flasher programme for 
the 16F84 PIC .. 60 
A Giistib-6) GE Weree Cela te 4 
BET portage schanioines. 23 
M 
p-law quantisation .... 152 
Media Control Interface 
(MC Irae ire 199 
Microchip PIC processor 55 
Microcontrollers...... 55 
Mini DDS (direct digital 
synthesis)....... 145 
Modemoutsinepu. cere 2, 
Motorola 56000 DSP 
family... ..ueea 175 
MSDOS tiene 2 


Multiplication, binary . 109 


N 
‘Negative frequency ... 163 


Negative numbers ..... 16 
IN IM BRAC lacy sere 53 
INOISe Far tics scauie aera 48 

aVeTia SIN Oye aan core 49 
Notification code ..... 196 


Null-terminated string .. 12 


Numbers within computers, 


representations 
Of a sae Sci Leas 
Numerically controlled 
Oscillatom ann 153 
Nyquist criterion ..... 150 
O 
Oscillator, numerically 
controlled ...... 153 
P 
Racketitadioiae eee 2 
Fatalleli port tac nave 23 
Pascal a eee 10 
PCA EG <e) ots oe Di 2 
Peak detection ....... 50 
Personal computer ..... 1 
Phasing SSB generator 183 
Phasor diagram ...... 156 
PIC. ah). ee 5D 
PicATUne automatic 
antenna tuner... 134 
Piccolo’: adee alee 149 
Plug-and-playits als. 9k 3 
Powerbasic 2eaaeomer 7 
Programming 
PG RS 4k eee se v/ 
PICA reyitey 56 
Protected Mode ....... 18 
Pseudo-random 
SEQUENCE Ment 87 
Pseudocodeme sire 158 
Q 
Quadrature sampling. . 155 
Quantisation noise .... 152 
QuickBasi¢.; . 3... - 7 
R 
Reduced instruction set 
COMpPULei. seers OD 
Relay driver chips .... 111 
Remote control ...... 99 
over a telephone line 100 
over an RF link .... 105 
Representations of numbers 
within 
computers.... 11, 15 
RISGo skies cio cers 55 
IRS23 2 ese kre ence. 25 


S 
Sampling” (03) aan <a 149 
resolutioin | <7 ee 151 
Security, link .......: 107 
Setial port .20),« + seas 25 
Sound card 
y 20, 395) Oda G 
Spectral analysis....... 47 
Spectrogram.......... 21 
Spreadsheets... vemee 5 
Sire, textes cere 12 
SWR meter display ... 82 
T 
Aelemetry': 3-cy0ee 99, 112 
Telephone line remote 
controller ...... 100 
Text string .).52... ane 12 
Threads «+: Aetna 190 
Time domain data .... 153 


Timer, watchdog, for 
computer control of 


transmitter...... 45 
Timing assuiesi-tae, setae 31 
Transceiver control and 

interfaces........ 4] 
Tuning and scanning, 

AuLOMAtiCn: Mates 46 
Two’s complement ..... 16 
U 
Universal Serial Bus 

(USB) 3 ae Done 

¥ 

V 
Variables: «4 ap wee 11 

declarations: 3.00.6 18 
‘Vectorgram oo uae 156 
Wectorscopeny eeeenee 157 
Visual Basice:. a ean eee 7 
von Neuman 

architecture..... 174 
Ww 


Waveform generation . 86 
Window procedure ... 189 


Windowing.......... 164 
Window panels ...... 189 
Windows........ 2, 3, 187 
APT tedepht ales oes 190 
Multimedia 
Extensions...... 199 
WiIVEMIE Sano oer 199 
Wrapper function..... 199 


Extra resources for this book are at www.rsgb.org/books/extra/command.htm 


il 
eee ie 
7 .. 
_ 
1 si . 
1 wi Ah 


COMMAND 


Computers, Microcontrollers and DSP for the Radio Amateur 
This book is for the radio amateur and home experimenter who wants to use modem digital and computer 
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